diff options
Diffstat (limited to 'doc/development/documentation/topic_types/concept.md')
-rw-r--r-- | doc/development/documentation/topic_types/concept.md | 14 |
1 files changed, 12 insertions, 2 deletions
diff --git a/doc/development/documentation/topic_types/concept.md b/doc/development/documentation/topic_types/concept.md index 66af8780b9b..c9aedf940a2 100644 --- a/doc/development/documentation/topic_types/concept.md +++ b/doc/development/documentation/topic_types/concept.md @@ -37,9 +37,19 @@ Do not include links to related tasks. The navigation provides links to tasks. ## Concept topic titles -For the title text, use a noun. For example, `Widgets` or `GDK dependency management`. +For the title text, use a noun. For example: -If a noun is ambiguous, you can add a gerund. For example, `Documenting versions` instead of `Versions`. +- `Widgets` +- `GDK dependency management` + +If you need more descriptive words, use the `ion` version of the word, rather than `ing`. For example: + +- `Object migration` instead of `Migrating objects` or `Migrate objects` + +Words that end in `ing` are hard to translate and take up more space, and active verbs are used for task topics. +For details, see [the Google style guide](https://developers.google.com/style/headings#heading-and-title-text). + +### Titles to avoid Avoid these topic titles: |