Style Guide

This style guide outlines the writing principles for Agpedia.

General principles

• Audience: Agpedia is written for a general audience. While we rely on diverse sources (academic, primary, etc.), we maintain our own accessible tone and do not necessarily adopt the style of our sources.
• Tone: We generally write in an encyclopedic style, grounding claims with citations. Analysis and value judgments should be clearly distinguished and placed in dedicated sections.
• Formatting:
  • Bold is used sparingly. In the lead section, bold the article title on its first occurrence, and also bold significant alternative names by which the subject is also known (e.g., "Mumbai, also known as Bombay..."). Do not bold the title again elsewhere in the article. Outside the lead, bold may be used in lists or tables to highlight key terms, but avoid over-bolding.
  • Italics may be used for emphasis and are generally used for titles of works (e.g., books, movies).
• Structure: Tables are encouraged to help readers navigate complex information.
• Perspective: While Agpedia is guided by its values, avoid being self-referential. For example, describe the impact on human agency directly ("this policy has effectively limited access to health insurance") rather than explaining why we are noting it.

Technical level and accessibility

Write for a reader who is intelligent and broadly educated, but has no prior knowledge of the topic. The goal is not to simplify — it is to be clear. Technical depth and accessibility are not opposites: a well-written technical article is both precise and followable.

• Define terms on first use. Do not assume familiarity with jargon or field-specific vocabulary. Gloss a technical term the first time it appears, even if it seems obvious in context. If the term has its own article, link it; if not, define it inline.
• Lead with the general, then the specific. The lead section should be comprehensible without domain knowledge. Technical depth belongs in body sections, where a reader who wants more can follow.
• Prefer plain words when precision is not lost. When a simpler word is equally precise, choose it ("use" over "utilize", "shows" over "demonstrates"). Do not simplify when it changes or weakens the meaning.
• Avoid nominalization where possible. Prefer "the system failed" over "failure of the system occurred." Dense noun chains obscure meaning without adding precision.
• Use examples and analogies freely. A concrete example or analogy makes a concept genuinely accessible without sacrificing accuracy. This is not dumbing down — it is good expository writing.

Headings

• H1 is reserved for the page title and is never used within article body content. Sections use H2; subsections use H3 and beyond.
• Page titles use AP Style title case: capitalize the first and last words, all "major" words (nouns, verbs, adjectives, adverbs), and prepositions of four or more letters; lowercase articles (a, an, the), coordinating conjunctions (and, but, or, nor, for, so, yet), and prepositions of three or fewer letters unless they open the title.
• Section headings (H2 and below) use sentence case — capitalize only the first word and proper nouns (e.g., "History of the labour movement", not "History of the Labour Movement").

Lead section

• Every article should begin with a lead section — body text that appears before the first H2 heading. The lead requires no heading of its own.
• The lead should be one to four paragraphs long and function as a self-contained overview of the article. A reader who reads only the lead should come away with an accurate summary of the topic.
• The first sentence should define or identify the subject concisely. For biographical articles, it should state the person's full name, birth and death dates (where known), nationality, and primary claim to notability. For concepts, it should provide a plain-language definition.
• Emphasis in the lead should reflect the relative importance of each point — do not bury the most significant information.

Dates

• Write dates in the format January 1, 2020 — month name in full, followed by the day and four-digit year. Do not use ISO format (2020-01-01) or day-first format (1 January 2020) in article prose.

Links

• Do not include "See also" or "External links" sections. In article body text, use internal links only — external links belong in citations, not in prose.
• Link only to pages that already exist, and only where the link genuinely aids understanding in context. Do not create speculative links to pages that do not yet exist.
• Links should appear naturally in the article flow — not collected at the end or forced into lists purely for navigation.

Slugs

• Slugs are always lowercase; spaces are replaced with hyphens (e.g., barack-obama, not Barack_Obama).
• Article slugs live in the root namespace — e.g., /barack-obama. There is no /wiki/ or similar prefix.
• Pages that are not articles use a /meta/ prefix — e.g., /meta/style.
• Some prefixes are reserved by the software and must not be used for content pages. Notably, /tool/ is reserved for special software pages.

Words to watch

Avoid the following language patterns, which weaken verifiability or mislead readers:

• Puffery and promotional language: Words like leading, world-class, innovative, cutting-edge, or renowned assert significance without evidence. Replace with specific, sourced claims.
• Weasel words: Vague attributions like "some say," "many believe," "it has been suggested," or "critics argue" without identifying who actually makes the claim. Attribute opinions to named sources.
• Unsourced superlatives: Claims that something is "the first," "the largest," "the most important," etc., require a citation.
• Editorializing: Avoid inserting value judgments into factual prose without explicit labeling. If a value judgment is warranted, place it in a dedicated Analysis section and attribute it clearly per the Citation Standards.
• Vague intensifiers: Words like significant, important, notable, or key should be used only when backed by sourced evidence of significance, not as decoration.