All pages
Powered by GitBook
1 of 1

Loading...

Documentation Style Guide

Style Guide

We adhere to the Google developer documentation style guide. Here are some links to particularly important resources from that style guide:

  • Word list – an alphabetically ordered list that allows you to quickly find words to use, or not to use, and recommendations of words and terms to use.

  • – write inclusive documentation for a global audience.

  • – avoid words and terms like currently, existing, in the future, now, or soon.

  • – when to use the Shift key, and how to format . We use upper case for headings, which is about the only deviation from the Google style guide.

  • – how to use acronyms and initialisms.

  • – how to properly use colons, commas, dashes, etc.

  • – how to write dates and times, headings and titles, when to use or rather .

  • – how to properly write links.

  • – how to write and format code blocks.

  • – and how to use filenames and trademarks.

Additional Information

Version-specific information: We refer to software versions (like "MariaDB 10.6") only for products (like MariaDB Server or MaxScale) or features (like replication or authentication) that follow the N-1 rule, where N is the last version still under maintenance. (At the time of writing, that's MariaDB 10.6 for the Server.) In other words, we'd mention MariaDB 10.5, but not versions older than that. This is the principle, from which we will deviate if there's a valid reason to do so.

Accessibility
Timeless documentation
Capitalization
headings and titles
Abbreviations
Punctuation
Formatting and organization
lists
tables
Cross-references
Code samples
Example domain names, IP numbers, and person names