howto/git.md

@@ -322,6 +322,31 @@ mirror or archive the repository to GitLab (yet).
 > (That said, it *should* be possible to do the following procedure to
 > automate this:
 >
+>  1. visit the [project import page](https://gitlab.torproject.org/projects/new#import_project)
+>
+>  2. enter the project URL, something like:
+>
+>         https://git.torproject.org/$GITOLITE_PROJECT
+>
+>  3. pick a project name, verify the project slug matches
+>
+>  4. pick the project namespace (hint: `tpa` will autocomplete to
+>     `tpo/tpa`)
+>
+>  5. hit <kbd>Create</kbd>
+>
+>  6. once the import complete, if requested, archive the repository
+>     by going to Settings -> General (Advanced) -> Expand -> Archive
+>     Project
+>
+>  7. change the `.mrconfig` in [tpo/tpa/repos.git](https://gitlab.torproject.org/tpo/tpa/repos.git) to point to the
+>     new repository
+>
+> Alternatively, the [create project API has an `import_url`
+> field](https://docs.gitlab.com/ee/api/projects.html#create-project). that could be used to automate the above.
+>
+> Another way to do this, from the command-line, would be:
+>
 >  1. clone the repository
 >
 >         git clone https://git.torproject.org/$GITOLITE_PROJECT
@@ -335,8 +360,10 @@ mirror or archive the repository to GitLab (yet).
 >
 >  4. optionally archive the GitLab project
 >
-> Steps 4 and 5 would require GitLab API access. Alternatively, the
-> [create project API has an `import_url` field](https://docs.gitlab.com/ee/api/projects.html#create-project).)
+>  5. change the `.mrconfig` in [tpo/tpa/repos.git](https://gitlab.torproject.org/tpo/tpa/repos.git) to point to the
+>     new repository
+>
+> Steps 4 and 5 would require GitLab API access.)
 
 The procedure is this simple two-step process: