Commit fb55ba5b authored by Mike Lewis's avatar Mike Lewis

Updates to doc improvements workflow

parent 01d23dfe
......@@ -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
......
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