Wiki Guidelines
How the wiki is organised.
The wiki is structured as a multi-topic reference system. Every page belongs to a topic and category, uses consistent frontmatter, and links to related content through tags and glossary terms. These guidelines keep things consistent.
Topics
Content is split into three topics:
- Shoots — firearms, shooting sports, kit, events, law, safety
- Plays — gaming, game reviews, tactics, software tools
- Codes — programming, projects, AI, career, hardware
Every wiki entry belongs to exactly one topic. The topic determines the accent colour, iconography, and section placement on the site.
Categories
Each topic is subdivided into categories. These group related articles and are listed in the sidebar topic tree. When adding a new page, choose the most specific existing category. If none fits, open an issue to discuss adding one.
Frontmatter
Every wiki entry requires the following frontmatter fields:
articleId— unique ID (e.g.SHO-EVE-SHO)title— page titlesummary— one- or two-sentence descriptionkind—review,article, orguidetopic—shoots,plays, orcodescategory— valid category ID within the topictags— array of tag slugs (see existing entries for convention)createdAt/updatedAt— ISO 8601 dates
See any existing file in src/content/wiki/ for a complete example.
Glossary Terms
Reusable terminology is defined in src/content/glossary/. When
a glossary term appears in article text, it automatically renders as a
tooltip-linked term. Add new terms when you introduce specialised vocabulary
that appears across multiple articles.
Tags
Tags cut across topics and categories. Use existing tags from the tag index when possible. Create new tags sparingly — a tag should apply to at least a few articles to be useful.
Images
Store images in public/images/ under a subdirectory matching
the article ID. Use descriptive filenames. For third-party images used
editorially (product photos, event coverage, screenshots), credit the
original source in the article and note it in the PR description.
Writing Style
- Write for a reader who is curious but not yet knowledgeable — define terms, explain context.
- Keep paragraphs short. Use headings to break up long sections.
- Link to related wiki entries, glossary terms, and external references.
- Use lists, tables, and code blocks where they add clarity, not as decoration.
- British English spelling (organise, colour, centre).