Commit 8626c30d authored by Craig Norris's avatar Craig Norris

Merge branch 'sselhorn-master-patch-73438' into 'master'

Updated with more specific instructions for community contributors

See merge request gitlab-org/gitlab!76274
parents cce79e2a ed15bdc9
...@@ -4,66 +4,44 @@ group: unassigned ...@@ -4,66 +4,44 @@ group: unassigned
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
--- ---
# Documentation process # How to update GitLab documentation
The process for creating and maintaining GitLab product documentation allows Anyone can contribute to the GitLab documentation! You can create a merge request for documentation when:
anyone to contribute a merge request or create an issue for GitLab
documentation.
Documentation updates relating to new features or feature enhancements must
use the [feature workflow process](https://about.gitlab.com/handbook/engineering/ux/technical-writing/workflow/#for-a-product-change) described in the GitLab Handbook.
## Who updates the docs?
*Anyone* can contribute! You can create a merge request for documentation when:
- You find errors or other room for improvement in existing documentation. - You find errors or other room for improvement in existing documentation.
- You have an idea for all-new documentation that would help a GitLab user or administrator to - You have an idea for all-new documentation that would help a GitLab user or administrator to
accomplish their work with GitLab. accomplish their work with GitLab.
## Documentation labels If you are working on a feature or enhancement, use the
[feature workflow process described in the GitLab Handbook](https://about.gitlab.com/handbook/engineering/ux/technical-writing/workflow/#for-a-product-change).
Regardless of the type of issue or merge request, certain labels are required when documentation
is added or updated. The following are added by the issue or merge request author:
- An appropriate [type label](../contributing/issue_workflow.md#type-labels).
- The [stage label](../contributing/issue_workflow.md#stage-labels) and
[group label](../contributing/issue_workflow.md#group-labels). For example, `~devops::create` and
`~group::source code`.
- The `~documentation` [specialization label](../contributing/issue_workflow.md#specialization-labels).
The following are also added by members of the Technical Writing team:
- A documentation [scoped label](../../user/project/labels.md#scoped-labels) with the
`docs::` prefix. For example, `~docs::improvement`.
- The `~Technical Writing` [team label](../contributing/issue_workflow.md#team-labels).
Documentation changes that are not associated with the release of a new or updated feature
do not take the `~"type::feature"` label, but still need the `~documentation` label.
They may include:
- Documentation created or updated to improve accuracy, completeness, ease of use, or any reason
other than a [feature change](https://about.gitlab.com/handbook/engineering/ux/technical-writing/workflow/#for-a-product-change).
- Addressing gaps in existing documentation, or making improvements to existing documentation.
- Work on special projects related to the documentation.
## How to update the docs ## How to update the docs
To update GitLab documentation: If you are not a GitLab team member, or do not have the Developer role for the GitLab repository, to update GitLab documentation:
1. Either: 1. Select an issue you'd like to work on.
- Click the **Edit this Page** link at the bottom of any page on <https://docs.gitlab.com>. - You don't need an issue to open a merge request.
- Navigate to one of the repositories and documentation paths listed on the - For a Hackathon, in the issue, in a comment, mention the person who opened the issue and ask for the issue to be assigned to you.
[GitLab Documentation guidelines](index.md) page. To be fair to other contributors, if you see someone has already asked to work on the issue, choose another issue.
1. Follow the described standards and processes listed on the page, including: If you are looking for issues to work on and don't see any that suit you, you can always fix [Vale](testing.md#vale) issues.
- The [Structure and template](structure.md) page. 1. Go to the [GitLab repository](https://gitlab.com/gitlab-org/gitlab).
- The [Style Guide](styleguide/index.md). 1. In the top-right, select **Fork**. Forking makes a copy of the repository on GitLab.com.
- The [Markdown Guide](https://about.gitlab.com/handbook/markdown-guide/). 1. In your fork, find the documentation page by going to the `\doc` directory.
1. Follow the [Merge Request Guidelines](../contributing/merge_request_workflow.md#merge-request-guidelines). 1. If you know Git, make your changes and open a merge request.
If not, follow these steps:
NOTE: 1. In the top right, select **Edit**, make the changes, and **Save**.
Work in a fork if you do not have the Developer role in the GitLab project. 1. From the left menu, select **Merge requests**.
1. For the source branch, select your fork and branch. If you did not create a branch, select `master`.
For the target branch, select the [GitLab repository](https://gitlab.com/gitlab-org/gitlab) `master` branch.
1. For the commit message, use 3-5 words, start with a capital letter, and do not end with a period.
1. Select **Commit changes**. A merge request opens.
1. Select the **Documentation** template. In the description, write a brief summary of the changes and link to the related issue, if there is one.
If you need help while working on the page, view:
- The [Style Guide](styleguide/index.md).
- The [Word list](styleguide/word_list.md)
- The [Markdown Guide](https://about.gitlab.com/handbook/markdown-guide/).
### Ask for help ### Ask for help
...@@ -83,6 +61,22 @@ To identify someone who can help you: ...@@ -83,6 +61,22 @@ To identify someone who can help you:
If you are a member of the GitLab Slack workspace, you can request help in `#docs`. If you are a member of the GitLab Slack workspace, you can request help in `#docs`.
## Documentation labels
When you author an issue or merge request, you must add these labels:
- A [type label](../contributing/issue_workflow.md#type-labels).
- A [stage label](../contributing/issue_workflow.md#stage-labels) and [group label](../contributing/issue_workflow.md#group-labels).
For example, `~devops::create` and `~group::source code`.
- A `~documentation` [specialization label](../contributing/issue_workflow.md#specialization-labels).
A member of the Technical Writing team adds these labels:
- A [documentation scoped label](../../user/project/labels.md#scoped-labels) with the
`docs::` prefix. For example, `~docs::improvement`.
- The [`~Technical Writing` team label](../contributing/issue_workflow.md#team-labels).
- A type label: either `~"type::feature"` or `~"type::maintenance"`.
### Reviewing and merging ### Reviewing and merging
Anyone with the [Maintainer role](../../user/permissions.md) to the relevant GitLab project can Anyone with the [Maintainer role](../../user/permissions.md) to the relevant GitLab project can
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment