Improving Documentation

1. You are here:
2. Handbook
3. Support Team Handbook
4. Support Workflows
5. Improving Documentation

Whenever possible, include a link to the applicable documentation as part of your response to a ticket. If the documentation does not exist yet, then make the documentation and send the link to the Draft MR in the response. For those situations in which making documentation is a more time-consuming exercise, we have set up a process to automatically create an issue in the GitLab issue tracker to track documentation tasks that needs to be completed:

• Apply a macro General::Document This to the ticket. This macro will apply the create_doc_issue tag and prefill the template for you to fill out.
• Fill out the template changing the title and the description. Example of the filled out template:

CREATE DOCUMENTATION ISSUE
Title: Document how to use Y with an X
Description
There is a new cool feature Y that we released last month. It can be used with X to improve Z. We need to document how Y can be used with X. 

## Test h2 header

We should remember to document:

1. requirements
1. how to enable
1. how to configure
1. how to troubleshoot

• Submit as internal note. When issue is created doc_issue_created tag will be added to the ticket.

If you need to create multiple issues using this workflow, just apply the macro once again. The automation creates issues with label_name[]=documentation&label_name[]=customer and assigns them to the agent who submitted the internal note.

Note: Make sure to use the template so that your internal note is correctly parsed by the trigger.

This workflow is implemented using a zendesk trigger that parses the internal note and sends it to Zendesk's HTTP target that creates a documentation issue.

When working on creating new docs, please follow the documentation styleguide.