[go: up one dir, main page]
Skip to content

Docs tutorial: Migrate to GitLab

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

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:

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:

  1. Any preparation required on the source platform.
  2. 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).
  3. The specific steps for the specific import from a platform. I think this would largely reuse existing documentation.
  4. 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.

Edited by 🤖 GitLab Bot 🤖