Get started page type
A Get started page introduces high-level concepts for a broad feature area. While a specific feature might be defined in the feature documentation, a Get started page gives an introduction to a set of concepts. The content should help the user understand how multiple features fit together as part of the larger GitLab workflow.
When to use a Get started page
For now, a Get started page should be used only at the highest level of the left navigation. For example, you might have a Get started page under Manage your organization or Extend GitLab.
A Get started page is different from a tutorial. A Get started page focuses on high-level concepts that are part of a workflow, while a tutorial helps the user achieve a task. A Get started page should point to tutorials, however, because tutorials are a great way for a user to get started.
Format
Get started pages should be in this format:
title: Get started with abc
---
These features work together in this way. You can use them to achieve these goals.
Include a paragraph that ties together the features without describing what
each individual feature does.
Then add this sentence and a diagram. Details about the diagram
file are below.
The process of <abc> is part of a larger workflow:

## Step 1: Do this thing
Each step should group features by workflow. For example, step 1 might be:
`## Step 1: Determine your release cadence`
Then the content can explain milestones, iterations, labels, etc.
The terms can exist elsewhere in the docs, but the descriptions
on this page should be relatively brief.
Finally, add links, in this format:
For more information, see:
- [Create your first abc](link.md).
- [Learn more about abc](link.md).
## Step 2: The next thing
Don't link in the body content. Save links for the `for more information` area.
For more information, see:
- [Create your first abc](link.md).
- [Learn more about abc](link.md).
Get started page titles
For the title, use Get started with topic_name
.
For the left nav, use Getting started
.
Get started file location
All Getting started files should be in the folder doc/user/get_started/
.
You do not need to create a subfolder for each file.
Diagram files
The diagram files are in this Google Slides doc.
Example
For an example of the Get started page type, see Get started learning Git.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support