diff options
author | Mike Lewis <mlewis@gitlab.com> | 2018-12-28 00:59:22 +0300 |
---|---|---|
committer | Mike Lewis <mlewis@gitlab.com> | 2018-12-28 00:59:22 +0300 |
commit | fb55ba5b91eb570db78784bca2fdc1619936996d (patch) | |
tree | f5047f0a3df8d7413288737dce2375b3c9b6df4d /doc | |
parent | 01d23dfe2adb8a4ce99f0a3232a9d6c1422dd30e (diff) |
Updates to doc improvements workflow
Diffstat (limited to 'doc')
-rw-r--r-- | doc/development/documentation/improvement-workflow.md | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/development/documentation/improvement-workflow.md b/doc/development/documentation/improvement-workflow.md index 9d13c81449e..cc8f60c27c7 100644 --- a/doc/development/documentation/improvement-workflow.md +++ b/doc/development/documentation/improvement-workflow.md @@ -17,6 +17,10 @@ when you find errors or other room for improvement, or have an idea for all-new documentation that would help a GitLab user or admin achieve or optimize their DevOps workflows. +## How to update the docs + +Follow GitLab's [Merge Request Guidelines](../contributing/merge_request_workflow.md#merge-request-guidelines). + ## Content: what belongs in the docs In docs, we share any and all helpful info/processes/tips with customers, but @@ -25,6 +29,10 @@ actions. There is no reason to withhold 'risky' steps and store them in another location; simply include them along with the rest of the docs, with all necessary detail including specific warnings and caveats. +Any content that is relevant to users or admins may be included. You can freely +include presentations, videos, etc.; no matter who it was originally written for, +if it is helpful to any of our audiences, we can include it. + A `Troubleshooting` section in doc pages is part of the default [template](structure.md) for a new page, and can freely be added to any page. @@ -41,6 +49,11 @@ that it meets the [Documentation Guidelines](index.md) and [Style Guide](stylegu If the author or reviewer has any questions, or would like a techncial writer's review before merging, mention the writer who is assigned to the relevant [DevOps stage](https://about.gitlab.com/handbook/product/categories/#devops-stages). +## Technical Writer Review + +The technical writing team reviews changes after they are merged, unless one of +the technical writers already reviewed prior to the merge. + ## Other ways to help If you have ideas for further documentation resources that would be best |