improve gitlab pages docs, thanks juga

See gitlab#97

howto/gitlab.md

@@ -387,7 +387,7 @@ this will be implemented, if ever.
 ## Publishing GitLab pages
 
 GitLab features a way to publish websites directly from the continuous
-integration pipelines, called [GitLab pages](https://gitlab.com/gitlab-org/gitlab-pages). Complete
+integration pipelines, called [GitLab pages](https://docs.gitlab.com/ee/user/project/pages/). Complete
 documentation on how to publish such pages is better served by the
 official documentation, but creating a `.gitlab-ci.yml` should get you
 rolling. For example, this will publish a `hugo` site:
@@ -402,9 +402,17 @@ rolling. For example, this will publish a `hugo` site:
       only:
         - main
 
-If this file is committed in a project called `tpo/team/project`, the
-pages will be published to
-<https://tpo.pages.torproject.net/team/project/>.
+GitLab pages are published under the `*.pages.torproject.org` wildcard
+domain. There are two types of projects hosted at the TPO GitLab:
+sub-group projects, usually under the `tpo/` super-group, and user
+projects, for example `anarcat/myproject`. You can also publish a page
+specifically for a user. The URLs will look something like this:
+
+| Type of GitLab page | Name of the project created in GitLab | Website URL                                          |
+|---------------------|---------------------------------------|------------------------------------------------------|
+| User pages          | `username.pages.torproject.net`       | `https://username.pages.torproject.net`              |
+| User projects       | `user/projectname`                    | `https://username.pages.torproject.net/projectname`  |
+| Group projects      | `tpo/group/projectname`               | `https://tpo.pages.torproject.net/group/projectname` |
 
 ## Accepting merge requests on wikis
 
@@ -599,6 +607,7 @@ The virtual host for the `pages.torproject.org` domain was configured
 through the `profile::gitlab::web` class.
 
 ## SLA
+
 <!-- this describes an acceptable level of service for this service -->
 
 ## Migration from Trac
@@ -607,6 +616,7 @@ GitLab was put online as part of a migration from [Trac](howto/trac),
 see the [Trac documentation for details on the migration](howto/trac#gitlab-migration).
 
 ## Design
+
 <!-- how this is built -->
 <!-- should reuse and expand on the "proposed solution", it's a -->
 <!-- "as-built" documented, whereas the "Proposed solution" is an -->