This breaks the automatic generation, but it's unlikely anyone would
have noticed that anyways.

It would be better if those sections were represented in the folder
hierarchy as well, but that involves moving a lot of pages around,
which would break too many links.

Ideally, the GitLab wiki would support redirects, but unfortunately it
didn't seem to, in my tests:

https://forum.gitlab.com/t/gitlab-wiki-redirections-and-other-gollum-features/42993/1

home.md

@@ -2,6 +2,8 @@
 title: Torproject Sysadmin Team
 ---
 
+[[_TOC_]]
+
 # Torproject Sysadmin Team
 
 The Torproject System Administration Team is the team that keeps
@@ -23,7 +25,9 @@ For a list of services and which servers they run on check
   You can either edit it in gitlab directly, if you can, or you can clone
   ``git@gitlab.torproject.org:tpo/tpa/team.wiki`` and send us a patch.
 
-## documentation
+# Documentation
+
+This documentation is primarily aimed at users.
 
 <!-- update with `ls -d doc/*.md | sed 's/.md$//;s/\(.*\)/ * [\1](doc\/\1)/'` -->
 
@@ -40,56 +44,82 @@ For a list of services and which servers they run on check
  * [static-sites](doc/static-sites)
  * [svn-accounts](doc/svn-accounts)
 
-## howtos
+# Howtos
+
+This documentation is primarily aimed at sysadmins and establishes
+various procedures not necessarily associated with a specific service.
 
 <!-- update with `ls -d howto/*.md | sed 's/.md$//;s/\(.*\)/ * [\1](howto\/\1)/'` -->
 
- * [backup](howto/backup)
  * [build_and_upload_debs](howto/build_and_upload_debs)
- * [cache](howto/cache)
- * [conference](howto/conference)
  * [create-a-new-user](howto/create-a-new-user)
  * [cumin](howto/cumin)
+ * [fabric](howto/fabric)
+ * [incident-response](howto/incident-response)
+ * [new-machine](howto/new-machine)
+ * [new-machine-hetzner-cloud](howto/new-machine-hetzner-cloud)
+ * [new-machine-hetzner-robot](howto/new-machine-hetzner-robot)
+ * [new-machine-mandos](howto/new-machine-mandos)
+ * [new-machine](howto/new-machine)
+ * [new-person](howto/new-person)
+ * [raid](howto/raid)
+ * [retire-a-host](howto/retire-a-host)
+ * [retire-a-user](howto/retire-a-user)
+ * [upgrades](howto/upgrades)
+
+# Service documentation
+
+This documentation covers all services hosted at TPO.
+
+Every service hosted at TPO should have a documentation page, either
+in this wiki, or elsewhere (but linked here). Services should ideally
+follow this [template](howto/template) to ensure proper documentation.
+
+## Internal services
+
+Those are services managed by TPA directly.
+
+ * [backup](howto/backup)
+ * [cache](howto/cache)
  * [dns](howto/dns)
  * [drbd](howto/drbd)
- * [fabric](howto/fabric)
  * [ganeti](howto/ganeti)
  * [git](howto/git)
- * [gitlab](howto/gitlab)
  * [grafana](howto/grafana)
- * [incident-response](howto/incident-response)
  * [ipsec](howto/ipsec)
- * [irc](howto/irc)
  * [kvm](howto/kvm)
  * [ldap](howto/ldap)
  * [letsencrypt](howto/letsencrypt)
  * [logging](howto/logging)
  * [lvm](howto/lvm)
  * [nagios](howto/nagios)
- * [new-machine](howto/new-machine)
- * [new-machine-hetzner-cloud](howto/new-machine-hetzner-cloud)
- * [new-machine-hetzner-robot](howto/new-machine-hetzner-robot)
- * [new-machine-mandos](howto/new-machine-mandos)
- * [new-machine](howto/new-machine)
- * [new-person](howto/new-person)
  * [openstack](howto/openstack)
  * [postgresql](howto/postgresql)
  * [prometheus](howto/prometheus)
  * [puppet](howto/puppet)
- * [raid](howto/raid)
- * [retire-a-host](howto/retire-a-host)
- * [retire-a-user](howto/retire-a-user)
- * [rt](howto/rt)
  * [static-component](howto/static-component)
- * [submission](howto/submission)
- * [svn](howto/svn)
- * [template](howto/template)
  * [tls](howto/tls)
- * [trac](howto/trac)
- * [upgrades](howto/upgrades)
  * [wkd](howto/wkd)
 
-## meetings
+## Non-TPA services
+
+Those are managed by service admins, and not directly the
+responsability of the TPA team.
+
+ * [gitlab](howto/gitlab)
+ * [irc](howto/irc)
+ * [rt](howto/rt)
+ * [svn](howto/svn)
+
+## Retired or researched services
+
+Those services have been either retired or have not been implemented yet.
+
+ * [conference](howto/conference)
+ * [submission](howto/submission)
+ * [trac](howto/trac)
+
+# Meetings
 
 We also keep our minutes here.
 
@@ -114,7 +144,7 @@ We also keep our minutes here.
  * [monthly-report](meeting/monthly-report)
  * [template](meeting/template)
 
-## policies
+# Policies
 
  * [tpa-rfc-1-policy](policy/tpa-rfc-1-policy)
  * [tpa-rfc-2-support](policy/tpa-rfc-2-support)