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:
General::Document Thisto the ticket. This macro will apply the
create_doc_issuetag and prefill the template for you to fill out.
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
doc_issue_createdtag 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.
When working on creating new docs, please follow the documentation styleguide.