How to Use

This is a reference guide, to be used as guidance when developing your own content. This is not meant to be read through sequentially, but rather is intended to provide quick references to voice, tone, grammar, format, technical, and accessibility questions. This document offers way to appropriately present your information in the Fortinet Hugo theme.

Each section outlines specific topics and provides examples in depth for your use. The top level links on the right side provide a tl;dr style summary for the pages encompassed in that chapter.

Quicklinks for the rest of this guide:

• Grammar, Voice, and Tone
  • Grammar Mechanics
  • Voice and Tone
  • Audiences and Personas
  • Content Structure
• Format
  • Markdown
    • Headers
    • Text Stylization
    • Horizontal Rules
    • Keyboard Shortcuts
    • Code and CLI
    • Lists
    • Definitions
    • Tables
    • Block Quotes
    • Links
  • Shortcodes
    • About Shortcodes
    • Badges
    • Buttons
    • Expand Capabilities
    • Icons
    • Mermaid
    • Notice Boxes
    • Tabs
  • Visual Aids
• Glossary
• Appendix A - External References
• Contributors