Garmin Wiki:Style guide
Appearance
📋 Official Policy
This page documents an official Garmin Wiki policy. Please discuss proposed changes on the talk page.
This style guide defines how articles on Garmin Wiki should be formatted for consistency and readability.
Article Structure
Feature Articles
Feature articles (e.g., Pulse Ox, Body Battery) should follow this structure:
- Lead section — Brief overview of the feature (2-3 sentences)
- How It Works — Technical explanation
- Supported Devices — Which watches have this feature (use
{{Connected Watches}}) - Settings and Configuration — How to enable/configure
- Accuracy and Limitations — Known limitations or accuracy considerations
- See Also — Related features
- References — Citations
Device Articles
Device articles (e.g., Fenix 8, Forerunner 965) should follow this structure:
- Lead section — Device name, release date, brief description
- Specifications — Table of key specs
- Features — Major features with links to feature articles
- Variants — Different sizes, colors, editions
- See Also — Related devices
- References — Citations
Formatting
Headings
- Use sentence case for headings: "How it works" not "How It Works"
- Don't skip heading levels (e.g., don't go from == to ====)
- Don't use headings for single sentences
Lists
Use bullet points for:
- Unordered lists of features
- Lists of related items
Use numbered lists for:
- Step-by-step instructions
- Ordered processes
- Rankings
Bold and Italics
- Use bold for the article title in the first sentence
- Use bold sparingly for emphasis
- Use italics for:
- Product names on first mention
- Technical terms being defined
- Emphasis within quotes
Units and Measurements
Distance
- Use metric first, then imperial in parentheses: "42.2 km (26.2 mi)"
- For GPS accuracy, use meters: "3-meter accuracy"
Time
- Use hours and minutes: "14 hours" not "14h"
- For battery life, use days for longer durations: "21 days in smartwatch mode"
Weight
- Use grams first, then ounces: "47 g (1.7 oz)"
Display Size
- Use inches with one decimal: "1.4-inch display"
Terminology
Official Garmin Terms
Always use Garmin's official terminology:
- "Body Battery" not "body battery" or "BodyBattery"
- "Pulse Ox" not "Pulse Oximeter" or "SpO2" (unless quoting Garmin)
- "Training Readiness" not "training readiness score"
Capitalization
- Capitalize feature names: Body Battery, Training Status, Sleep Score
- Don't capitalize generic terms: heart rate, GPS, steps
Links
Internal Links
- Link to other wiki articles on first mention
- Don't over-link — once per section is usually enough
- Use descriptive link text: "blood oxygen monitoring" not "click here"
External Links
- Prefer Garmin.com for official documentation
- Always use HTTPS when available
- Don't link to paywalled content without noting it
Images
See Garmin Wiki:Image and media policy for detailed image guidelines.
- Use descriptive file names: "Fenix-8-solar-front.jpg" not "IMG_1234.jpg"
- Include alt text for accessibility
- Place images near relevant text
See Also
- Garmin Wiki:Editing guidelines — How to write content
- Garmin Wiki:Article naming conventions — How to name articles
- Garmin Wiki:Image and media policy — Image guidelines
- Help:Editing — Technical editing guide