Revision History: SUSE Documentation Style Guide (AsciiDoc)

2026-08-14

  • Added a section on articles: do not omit articles, do not use an article before a noun with an identifier, and repeat the article in a series if needed.

  • Added a section on jargon and slang.

  • Added a section on multi-word nouns with a limit of three words.

  • Added a section on phrasal verbs, listing the ones that remain accepted.

  • Added a section on pronouns, including sentence-initial this and that.

  • Added a section on terminology consistency: one term for one thing, and consistent phrasing for recurring actions.

  • Added a section on verbs: do not use names as verbs, prefer verbs over nominalizations, and keep the conjunction that.

2025-06-04