diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 6485b5799be51440198ce9654f12ff4eece3f974..4fb8aeadada597fe55ea3a1870f4fe02ddcd5b6a 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -258,10 +258,10 @@ pages:
     # resolve and build packages from the docs/Project.toml file
     - julia --project=docs -e 'using Pkg; Pkg.resolve(); Pkg.develop(PackageSpec(path=pwd())); Pkg.instantiate();'
 
-    # deploy doc (the without git history)
+    # build and deploy docs (this doesn't upload the gource animation asset)
     - julia --project=docs --color=yes docs/make.jl
 
-    # move to the directory picked up by Gitlab pages (with git history)
+    # move to the directory to be picked up by Gitlab pages (with assets)
     - mv docs/build public
   artifacts:
     paths: