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

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

48 lines
3 KiB
Markdown
Raw Normal View History

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
2021-03-11 19:13:27 +05:30
<!-- Link related issues below. -->
2019-05-05 18:10:48 +05:30
2021-09-30 23:02:18 +05:30
## Author's checklist
2019-05-05 18:10:48 +05:30
2022-06-21 17:19:12 +05:30
- [ ] Optional. Consider taking [the GitLab Technical Writing Fundamentals course](https://gitlab.edcast.com/pathways/ECL-02528ee2-c334-4e16-abf3-e9d8b8260de4).
2021-10-27 15:23:28 +05:30
- [ ] Follow the:
2021-11-11 11:23:49 +05:30
- [Documentation process](https://docs.gitlab.com/ee/development/documentation/workflow.html).
- [Documentation guidelines](https://docs.gitlab.com/ee/development/documentation/).
2021-10-27 15:23:28 +05:30
- [Style Guide](https://docs.gitlab.com/ee/development/documentation/styleguide/).
2022-06-21 17:19:12 +05:30
- [ ] If you're adding or changing the main heading of the page (H1), ensure that the [product tier badge](https://docs.gitlab.com/ee/development/documentation/styleguide/index.html#product-tier-badges) is added.
- [ ] If you are a GitLab team member, [request a review](https://docs.gitlab.com/ee/development/code_review.html#dogfooding-the-attention-request-feature) based on:
- The documentation page's [metadata](https://docs.gitlab.com/ee/development/documentation/#metadata).
- The [associated Technical Writer](https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments).
2021-06-08 01:23:25 +05:30
2022-06-21 17:19:12 +05:30
If you are a GitLab team member and only adding documentation, do not add any of the following labels:
2021-10-27 15:23:28 +05:30
- `~"frontend"`
- `~"backend"`
2021-12-11 22:18:48 +05:30
- `~"type::bug"`
2021-10-27 15:23:28 +05:30
- `~"database"`
These labels cause the MR to be added to code verification QA issues.
2019-05-05 18:10:48 +05:30
2022-06-21 17:19:12 +05:30
## Reviewer's checklist
2019-05-05 18:10:48 +05:30
2021-09-30 23:02:18 +05:30
Documentation-related MRs should be reviewed by a Technical Writer for a non-blocking review, based on [Documentation Guidelines](https://docs.gitlab.com/ee/development/documentation/) and the [Style Guide](https://docs.gitlab.com/ee/development/documentation/styleguide/).
2019-07-07 11:18:12 +05:30
2021-09-30 23:02:18 +05:30
- [ ] If the content requires it, ensure the information is reviewed by a subject matter expert.
- Technical writer review items:
- [ ] Ensure docs metadata is present and up-to-date.
- [ ] Ensure the appropriate [labels](https://about.gitlab.com/handbook/engineering/ux/technical-writing/workflow/#labels) are added to this MR.
2022-06-21 17:19:12 +05:30
- [ ] Ensure a release milestone is set.
2021-09-30 23:02:18 +05:30
- If relevant to this MR, ensure [content topic type](https://docs.gitlab.com/ee/development/documentation/structure.html) principles are in use, including:
- [ ] The headings should be something you'd do a Google search for. Instead of `Default behavior`, say something like `Default behavior when you close an issue`.
- [ ] The headings (other than the page title) should be active. Instead of `Configuring GDK`, say something like `Configure GDK`.
- [ ] Any task steps should be written as a numbered list.
- If the content still needs to be edited for topic types, you can create a follow-up issue with the ~"docs-technical-debt" label.
2022-01-26 12:08:38 +05:30
- [ ] Review by assigned maintainer, who can always request/require the reviews above. Maintainer's review can occur before or after a technical writer review.
2019-07-07 11:18:12 +05:30
2022-06-21 17:19:12 +05:30
/label ~documentation ~"type::maintenance" ~"docs::improvement"
2021-09-30 23:02:18 +05:30
/assign me