Revision History: SUSE Documentation Style Guide (DocBook)

2026-08-14

  • Added a section on paragraph structure: topic sentences, one topic per paragraph, and a maximum of six sentences.

  • Split the sentence length limit into 25 words for running text and 20 words for procedure steps, and added rules for counting words.

  • Added a rule to write one instruction per step, in the imperative form.

  • Clarified that notes and tips give information only and must not contain instructions, requirements or limits.

2025-06-04