debian-mirror-gitlab/.gitlab/merge_request_templates/Documentation.md

73 lines
4.9 KiB
Markdown
Raw Normal View History

2019-07-07 11:18:12 +05:30
<!-- Follow the documentation workflow https://docs.gitlab.com/ee/development/documentation/workflow.html -->
2019-12-21 20:55:43 +05:30
<!-- Additional information is located at https://docs.gitlab.com/ee/development/documentation/ -->
2020-04-08 14:13:33 +05:30
<!-- To find the designated Tech Writer for the stage/group, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers -->
2019-05-05 18:10:48 +05:30
<!-- Mention "documentation" or "docs" in the MR title -->
2019-07-07 11:18:12 +05:30
<!-- For changing documentation location use the "Change documentation location" template -->
2019-05-05 18:10:48 +05:30
## What does this MR do?
2019-07-07 11:18:12 +05:30
<!-- Briefly describe what this MR is about. -->
2019-05-05 18:10:48 +05:30
## Related issues
2019-07-07 11:18:12 +05:30
<!-- Link related issues below. Insert the issue link or reference after the word "Closes" if merging this should automatically close it. -->
2019-05-05 18:10:48 +05:30
2020-05-24 23:13:21 +05:30
## Author's checklist (required)
2019-05-05 18:10:48 +05:30
2019-07-07 11:18:12 +05:30
- [ ] Follow the [Documentation Guidelines](https://docs.gitlab.com/ee/development/documentation/) and [Style Guide](https://docs.gitlab.com/ee/development/documentation/styleguide.html).
2020-11-24 15:15:51 +05:30
- If you have **Developer** permissions or higher:
- [ ] Ensure that the [product tier badge](https://docs.gitlab.com/ee/development/documentation/styleguide.html#product-badges) is added to doc's `h1`.
2020-05-24 23:13:21 +05:30
- [ ] Apply the ~documentation label, plus:
2020-11-24 15:15:51 +05:30
- The corresponding DevOps stage and group labels, if applicable.
2020-05-24 23:13:21 +05:30
- ~"development guidelines" when changing docs under `doc/development/*`, `CONTRIBUTING.md`, or `README.md`.
- ~"development guidelines" and ~"Documentation guidelines" when changing docs under `development/documentation/*`.
- ~"development guidelines" and ~"Description templates (.gitlab/\*)" when creating/updating issue and MR description templates.
- [ ] Assign the [designated Technical Writer](https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments).
2020-06-23 00:09:42 +05:30
Do not add the ~"feature", ~"frontend", ~"backend", ~"bug", or ~"database" labels if you are only updating documentation. These labels will cause the MR to be added to code verification QA issues.
2020-05-24 23:13:21 +05:30
When applicable:
- [ ] Update the [permissions table](https://docs.gitlab.com/ee/user/permissions.html).
2019-07-07 11:18:12 +05:30
- [ ] Link docs to and from the higher-level index page, plus other related docs where helpful.
2020-11-24 15:15:51 +05:30
- [ ] Add the [product tier badge](https://docs.gitlab.com/ee/development/documentation/styleguide.html#product-badges) accordingly.
2020-05-24 23:13:21 +05:30
- [ ] Add [GitLab's version history note(s)](https://docs.gitlab.com/ee/development/documentation/styleguide.html#text-for-documentation-requiring-version-text).
- [ ] Add/update the [feature flag section](https://docs.gitlab.com/ee/development/documentation/feature_flags.html).
2019-05-05 18:10:48 +05:30
## Review checklist
2019-07-07 11:18:12 +05:30
All reviewers can help ensure accuracy, clarity, completeness, and adherence to the [Documentation Guidelines](https://docs.gitlab.com/ee/development/documentation/) and [Style Guide](https://docs.gitlab.com/ee/development/documentation/styleguide.html).
**1. Primary Reviewer**
* [ ] Review by a code reviewer or other selected colleague to confirm accuracy, clarity, and completeness. This can be skipped for minor fixes without substantive content changes.
2019-12-21 20:55:43 +05:30
2019-07-07 11:18:12 +05:30
**2. Technical Writer**
2020-07-28 23:09:34 +05:30
- [ ] Technical writer review. If not requested for this MR, must be scheduled post-merge. To request for this MR, assign the writer listed for the applicable [DevOps stage](https://about.gitlab.com/handbook/product/product-categories/#devops-stages).
2020-11-24 15:15:51 +05:30
- [ ] Ensure docs metadata are present and up-to-date.
- [ ] Ensure ~"Technical Writing" and ~"documentation" are added.
2021-01-03 14:25:43 +05:30
- [ ] Add the corresponding `docs::` [scoped label](https://gitlab.com/groups/gitlab-org/-/labels?utf8=%E2%9C%93&subscribed=&search=docs%3A%3A).
- [ ] If working on UI text, add the corresponding `UI Text` [scoped label](https://gitlab.com/groups/gitlab-org/-/labels?utf8=%E2%9C%93&subscribed=&search=ui+text).
2020-07-28 23:09:34 +05:30
- [ ] Add ~"tw::doing" when starting work on the MR.
- [ ] Add ~"tw::finished" if Technical Writing team work on the MR is complete but it remains open.
2019-07-07 11:18:12 +05:30
2021-01-03 14:25:43 +05:30
For more information about labels, see [Technical Writing workflows - Labels](https://about.gitlab.com/handbook/engineering/ux/technical-writing/workflow/#labels).
2021-01-29 00:20:46 +05:30
For suggestions that you are confident don't need to be reviewed, change them locally
and push a commit directly to save others from unneeded reviews. For example:
- Clear typos, like `this is a typpo`.
- Minor issues, like single quotes instead of double quotes, Oxford commas, and periods.
For more information, see our documentation on [Merging a merge request](https://docs.gitlab.com/ee/development/code_review.html#merging-a-merge-request).
2019-07-07 11:18:12 +05:30
**3. Maintainer**
1. [ ] Review by assigned maintainer, who can always request/require the above reviews. Maintainer's review can occur before or after a technical writer review.
2019-12-26 22:10:19 +05:30
1. [ ] Ensure a release milestone is set.
2019-12-21 20:55:43 +05:30
1. [ ] If there has not been a technical writer review, [create an issue for one using the Doc Review template](https://gitlab.com/gitlab-org/gitlab/issues/new?issuable_template=Doc%20Review).
2019-05-05 18:10:48 +05:30
2019-12-21 20:55:43 +05:30
/label ~documentation