Skip to content
logo
Percona Documentation Style Guide
Rules for specific documentation types
Initializing search
    percona/doc-style-guide
    percona/doc-style-guide
    • Home
    • Storytelling
      • Voice and Tone
      • Keep the Structure Simple
      • Use Cross-References Appropriately
    • Text
      • Hyphens
      • Paragraphs
      • Lists
      • Headings
      • Tables
      • Graphics
      • Callouts and admonitions
      • Code descriptions
      • SQL statement conventions
      • Links
      • Legal information
      • None
    • Grammar
      • Capitalization
      • Punctuation
      • Spelling
      • Word usage
      • Numbers
    • Writing
      • Rules for specific documentation types
        • Manuals
        • Reference Documents
    • Guidelines
    • Markup
    • Copyright and licensing
    • Trademark policy
    • Manuals
    • Reference Documents

    Rules for specific documentation types¶

    Manuals¶

    • Do not cross-reference totally new material that the reader might not understand based on the current context.
    • Give references to material that may become outdated, such as external resources, in the See also section at the end of the current section.
    • Do not make cross-references a continuation of the current story: readers should be able to understand the current section even if they decide not to read the cross-referenced material.

    Reference Documents¶

    • Cross-reference each occurrence of valuable assets, such as identifiers of JIRA tickets, bug reports, or security issues. However, make sure that you do not refer the reader to restricted information which may not be disclosed in the given document.

    Contact Us

    For free technical help, visit the Percona Community Forum.

    To report bugs or submit feature requests, open a JIRA ticket.

    For paid support and managed or consulting services , contact Percona Sales.


    Last update: June 26, 2023
    Created: June 26, 2023
    Percona LLC and/or its affiliates, © 2023
    Made with Material for MkDocs

    Cookie consent

    We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better. Read more about Percona Cookie Policy.