try a method to replicate wikis

howto/gitlab.md

@@ -406,6 +406,53 @@ 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/>.
 
+## Accepting merge requests on wikis
+
+It's possible to work around the [limitation of Wiki permissions](https://gitlab.torproject.org/tpo/tpa/gitlab/-/issues/76)
+by creating a mirror of the git wiki backing the wikis. This way
+more users can suggest changes to the wiki by submitting merge
+requests. It's not as easy as editing the wiki, but at least provides
+a way for outside contributors to participate.
+
+To do this, you'll need to create [project access tokens](https://gitlab.torproject.org/help/api/README.md#personalproject-access-tokens) in the
+Wiki and use the [repository mirror feature](https://gitlab.torproject.org/help/user/project/repository/repository_mirroring.md) to replicate the wiki
+into a separate project.
+
+ 1. in the Wiki project, head for the **Settings: Access Tokens** page
+    and create a new token with `write_repository` access
+
+ 2. optionally, create a new project for the wiki, for example called
+    [`wiki-replica`](https://gitlab.torproject.org/tpo/tpa/wiki-replica/). you can also use the same project as the wiki
+    if you do not plan to host other source code specific to that
+    project there. we'll call this the "wiki replica" in either case
+
+ 3. in the wiki replica, head for the **Settings: Mirroring
+    repositories** section and fill in the details for the wiki HTTPS
+    clone URL:
+
+     * Git repository URL: the HTTPS URL of the Git repository (which
+       you can find in the **Clone repository** page on the top-right
+       of the wiki)
+     * **Mirror direction**: `push` (only "free" option, `pull` is
+       non-free)
+     * **Authentication method**: `Password` (default)
+     * **Password**: the **Access token** you created in the first
+       step
+     * **Keep divergent refs**: checked (optional, should make sure
+       sync works in some edge cases)
+     * **Mirror only protected branches**: checked (to keep merge
+       requests from being needlessly mirrored to the wiki)
+
+When you click the **Mirror repository** button, a sync will be
+triggered. Refresh the page to see status, you should see the **Last
+successful update** column updated. When you push to the replica, the
+wiki should be updated.
+
+Naturally, because of limitations of GitLab, you cannot pull changes
+from the wiki to the replica. But considering only a limited set of
+users have access to the wiki in the first place, this shouldn't be a
+problem as long as everyone pushes to the replica.
+
 ## Pager playbook
 
 <!-- information about common errors from the monitoring system and -->