SUSE Documentation Style Guide

Welcome to the hub for SUSE’s writing standards. On this page, you can choose two fully maintained guides—one for DocBook XML, the other for AsciiDoc. Both guides answer the same questions about voice, terminology, structure and layout, but each applies rules that fit its own format. Choose your format, follow the conventions, and you’ll make your content clearer for readers, easier for translators and smoother for contributors—no matter which toolchain you prefer.

Download archive
SUSE Documentation Style Guide for DocBook XML

This guide provides answers to writing, style and XML layout questions for creating documentation using DocBook.

SUSE Documentation Style Guide for AsciiDoc

This guide offers writing, style and formatting recommendations for creating documentation with AsciiDoc.

No matching articles found

SUSE Logo