Skip to content
logo
Percona Documentation Style Guide
Text
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
    • Guidelines
    • Markup
    • Copyright and licensing
    • Trademark policy
    • General guidelines

    Text¶

    This section contains rules which are related to common text components such as paragraphs, headings, tables, and images.

    General guidelines¶

    In English, a mood indicates how a verb expresses an action or state of being. The three moods are:

    • Indicative
    • Imperative
    • Subjunctive

    An Indicative mood is used to make a factual statement:

    • The software runs in the Linux operating system.
    • When starting, the application checks to see if another instance is running.

    An imperative mood is used to express commands or requests:

    • Open the pod bay doors, Hal
    • Run the command from the terminal

    A subjunctive mood is infrequently used and often is used when suggesting or recommending an action. The subjunctive mood may cause doubt.

    • It is important that only administrators should read the log
    • The example shows a type of variable you could use when starting the application

    When writing, use either the indicative or imperative mood. Use the subjunctive mood when the information may be different for different users, such as presenting the output of a command (Your results should be similar).

    Guidelines:

    • Wrap lines at 80 characters
    • Filenames. Suggestion: Use a “-“ as a word separator in filename

    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.