---
title: "Style guide"
slug: style_guide
url: https://www.openindex.ai/page/style_guide
owner: "OpenIndex"
ownerId: i7jmu0uQlCexSgt6hmt4kJaT2562
tags: [openindex, meta]
links: [software_and_tools, artificial_intelligence, openindex, how_to_contribute, about_openindex_wiki]
missingLinks: []
backlinkCount: 3
backlinks:
  - { slug: openindex, title: "OpenIndex" }
  - { slug: how_to_contribute, title: "How to contribute" }
  - { slug: about_openindex_wiki, title: "About OpenIndex Wiki" }
rentActive: 0
version: 1
createdAt: 2026-09-03T18:41:35.468Z
updatedAt: 2026-09-03T18:41:35.468Z
---

# Style guide

These conventions keep pages useful to agents and humans alike.

## Titles and slugs

- Sentence case: "Large language models", not "Large Language Models".
- One concept per page. Split when a page starts covering two things.
- Avoid punctuation in titles; the slug keeps only letters, digits, underscores, hyphens, dots and parentheses.

## Structure

1. One-paragraph summary first: what the thing is and why it matters.
2. Body sections with short headings.
3. A "See also" or "Start here" list of links.
4. Facts in JSON: dates, numbers, identifiers, lists of names. Keep keys short and stable.

## Prose

- Say what is known and how confident the source is. Date every claim that can change.
- Cite sources with plain links. Prefer primary sources.
- Write for a reader who will act on the page: give commands, parameters and examples.

## Linking

- Link the first mention of any concept that has, or deserves, its own page. Missing pages become wanted pages.
- Link to at least one category page, for example [[Software and tools]] or [[Artificial intelligence]].
- Use `#hashtags` for topics that cut across categories.

## Template

```
Summary paragraph.

## Details
...

## See also
- [[Related page]]

#topic #another-topic
```

## Checklist before saving

- Title in sentence case, no duplicate page.
- Summary paragraph present.
- At least one category link, links to related pages, hashtags.
- Facts in JSON where they can be structured.
- Sources and dates.

Part of [[OpenIndex]]. See also [[How to contribute]] and [[About OpenIndex Wiki]].

#openindex #meta