diff --git a/doc/development/documentation/topic_types/index.md b/doc/development/documentation/topic_types/index.md index 381f70914c6a799cbd8fc2108830c54d5871a61f..3f055ca7ed732e45dc8f6fbe1c8fd666aef6208c 100644 --- a/doc/development/documentation/topic_types/index.md +++ b/doc/development/documentation/topic_types/index.md @@ -44,9 +44,11 @@ In general, for topic titles: - Be clear and direct. Make every word count. - Use articles and prepositions. -- Follow [capitalization](../styleguide/index.md#capitalization) guidelines. +- Follow [capitalization](../styleguide/index.md#topic-titles) guidelines. - Do not repeat text from earlier topic titles. For example, if the page is about merge requests, instead of `Troubleshooting merge requests`, use only `Troubleshooting`. +- Avoid using hyphens to separate information. + For example, instead of `Internal analytics - Architecture`, use `Internal analytics architecture` or `Architecture of internal analytics`. See also [guidelines for heading levels in Markdown](../styleguide/index.md#heading-levels-in-markdown).