Docs tutorial: Migrate to GitLab
Problem to solve
We already have Migrate to GitLab listed in the tutorials page: https://docs.gitlab.com/ee/tutorials/#plan-your-work-in-projects. However, when you follow the link (https://docs.gitlab.com/ee/user/project/import/index.html) you aren't presented with a tutorial as such, but rather a landing page that links to a variety of features.
Goal
The issue is resolved when either:
- The page at https://docs.gitlab.com/ee/user/project/import/index.html is refactored to this template: https://docs.gitlab.com/ee/development/documentation/topic_types/tutorial.html.
- The page at https://docs.gitlab.com/ee/user/project/import/index.html is reduced and a tutorial page is created which outlines the steps that are common to all migrations.
Alternative: Concentrate on the most common migration path, and optimize that to the https://docs.gitlab.com/ee/development/documentation/topic_types/tutorial.html template.
Basic outline
I think the tutorial can be written generically such that it would be applicable for folks coming from anywhere to GitLab. Something along the lines of:
- Any preparation required on the source platform.
- Any preparation required on the GitLab side. Many of the import methods have the same requirements (like specific roles required, but they are repeated across all pages).
- The specific steps for the specific import from a platform. I think this would largely reuse existing documentation.
- Any post-migration steps.
Alternative: Concentrate on the most common migration path, and optimize that to the https://docs.gitlab.com/ee/development/documentation/topic_types/tutorial.html template.
Place in navigation
The page at https://docs.gitlab.com/ee/user/project/import/index.html is already on the global navigation. If a new page is created, it would appear immediately under that page.
If the alternative option is taken, all the migration paths already has a place in the navigation.