Jump to content

Yezur Wiki:Conventions

From Yezur Wiki
Revision as of 19:38, 15 July 2026 by Khurouan (talk | contribs) (Create the wiki conventions and onboarding guide)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This page collects the editorial and structural conventions of the Yezur Wiki — a working reference for new editors, human and AI alike. The wiki is the single source of truth for the world of Yezur; these are the habits that keep it consistent.

The cardinal rule

A fact is canon only once it is written onto a wiki page. Conversation, agreement, and brainstorming are not canon until they land here.

Editorial voice

Articles in the main namespace are written as an encyclopedia by Yezuri, for Yezuri readers. Two requirements, always together:

  • Encyclopedic register. Neutral and third-person, definition-first, like any good reference work. No storytelling, no chatty asides, no first- or second-person address to the reader, no marketing or how-to tone.
  • In-world (Watsonian) frame. Written from inside Yezur. Never break frame: no comparisons to the real world, no asides to the real reader, no mention of the design process or the tools used to build the wiki.

No real-world references

Yezur is not Earth. Do not invoke real civilizations, cultures, religions, writing systems, landmarks, or figures by their real-world names — no "Latin script", no "Romanized", no real place or people names. Analogy is welcome: monarchies, pottery, navigation, cathedrals and countless familiar concepts exist here in recognizable forms — but each should feel grown from Yezur's own history, not lifted from a specific real culture.

No magic

No supernatural forces or spellcraft act on the physical world. In-world myths and folk beliefs may exist without being literally true.

Plausible mechanics

Biology, geology, and climate behave as in reality, and the cosmos is the real one; only the specifics — species, peoples, surface geography — are Yezuri.

Where out-of-frame content goes

Real-world commentary — design rationale, comparisons, notes on tooling, unresolved questions — never appears in article text. It belongs on Talk pages, in the Meta: namespace, or in this Yezur Wiki: namespace.

Namespaces

Namespace Frame Purpose
(Main), Dictionary:, Map: In-character Encyclopedia articles, the dictionary, and the map wiki
Yezur Wiki: Out-of-frame Policy, style, and conventions (this page)
Meta: Out-of-frame Design notes and rationale
Talk: (all) Out-of-frame Discussion and open threads

Rule of thumb: everything a reader or editor sees is in-character, except the Meta:, Talk:, and Yezur Wiki: namespaces. That includes template, module, and category names — see Naming.

Who edits as whom

  • Yezur is the human editor, working in the browser.
  • Khurouan is the AI author; every AI edit goes through this account, so authorship is clear at a glance in page history.

Keep edit summaries in-character where you reasonably can — describe the change to the article ("Start an article on the Hertic language"), not the process behind it.

Naming

  • Language articles use the "X language" form (e.g. Gaillean language). Native names and other aliases become redirects.
  • Language families currently carry placeholder labels ("Family A", and so on) until their in-world names are derived; use them sparingly.
  • Categories follow real-encyclopedia habits but drop the global "of Yezur" — we would not write "Rivers of Earth", so we write Continents, not "Continents of Yezur". Keep narrower place qualifiers, such as "Polities of Andusia".
  • Templates, modules, and categories are in-character too. Avoid real-world terms in their names; encyclopedia-furniture words (Infobox, Cite, Stub, Navbox) are fine, since the in-world encyclopedia uses them about itself.

Categories

Categories form a nested hierarchy — and, being a directed graph, a category may have more than one parent. Broad topics branch into specific sub-categories; a page joins the most specific categories that apply, not a flat top-level bucket. Entity-type categories nest inside topic branches: a country in Andusia sits in a "Polities of Andusia" category that is a child of both "Andusia" and "Polities".

Do not manufacture a category for every possible intersection. Build the main navigational branches; arbitrary slices — "polities in Andusia founded before a given year" — are answered by a Cargo query instead.

Infoboxes and structured data

  • Each entity type has its own infobox, kept granular: Template:Infobox former country is separate from the living-state Template:Infobox polity, so each carries only the fields that matter to it.
  • Infoboxes render through the shared Lua module Module:Infobox and one stylesheet, Template:Infobox/styles.css.
  • Each infobox also files its facts into a Cargo table, so lists, member rosters, and cross-references build and maintain themselves from the articles.
  • Store plain values in any field you will display in a Cargo query table: Cargo prints raw [[wikilinks]] in query cells. Link entities in the prose or infobox instead.
  • Adding a field to a Cargo table changes its schema, which needs a one-time administrative rebuild ("recreate data") on the template.

Open threads

Unresolved questions, placeholder names, and deliberate dangling references are recorded as plain text on the article's Talk page, under an == Open threads == heading — never as hidden markers inside the article.

Maps

Link to the Yezur map with {{Node}}, {{Way}}, and {{Relation}} (by object id), or {{Coords}} / {{Coordslink}} (by coordinates).

Sourcing

Cite sources with <ref>...</ref>, collected by a <references /> tag in a references section.

Notes for AI agents

Agents run locally and edit through the Khurouan account. Additional operating context — the project setup, the who-edits-as-whom rule, and this convention set — lives in the project's CLAUDE.md. Always read the relevant page(s) before asserting canon, and surface every write you make.