Jump to content

Garmin Wiki:Style guide

From Garmin Wiki

📋 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:

  1. Lead section — Brief overview of the feature (2-3 sentences)
  2. How It Works — Technical explanation
  3. Supported Devices — Which watches have this feature (use {{Connected Watches}})
  4. Settings and Configuration — How to enable/configure
  5. Accuracy and Limitations — Known limitations or accuracy considerations
  6. See Also — Related features
  7. References — Citations

Device Articles

Device articles (e.g., Fenix 8, Forerunner 965) should follow this structure:

  1. Lead section — Device name, release date, brief description
  2. Specifications — Table of key specs
  3. Features — Major features with links to feature articles
  4. Variants — Different sizes, colors, editions
  5. See Also — Related devices
  6. 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:

  1. Step-by-step instructions
  2. Ordered processes
  3. 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
  • 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"
  • 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
A project by GarminRumors.com