Io Writing Style

Writing Style (io-writing-style)

An IO paper must be readable by an international-relations scholar from a different tradition, framed around a generalizable IR theory, and disciplined to the word cap. This skill is about reaching the IR field and respecting IO's format — not about generating claims.

When to trigger

• Drafting the introduction, framing the IR contribution, or final polish
• Over the word cap and needing to cut without losing the argument
• Preparing the abstract, word count, and acknowledgments (submitted separately from the manuscript)
• Aligning citations/footnotes/format to IO conventions before submission

Reach the IR field (across paradigms)

1. Front-load the IR contribution. By the end of the introduction the reader knows the international question, the theory, the evidence, and why it matters for international politics. Don't make a reader from another tradition dig for the "so what."
2. Speak across rationalist / constructivist / IPE / security divides. Define paradigm-specific jargon on first use; a security scholar should follow an IPE paper and vice versa. Spell out IGO and dataset acronyms.
3. Argument-first prose. Lead with the IR claim; use evidence to support it. Avoid "the data show…" without saying what they show about international politics and why it matters.
4. Signpost. Clear section structure so a reader can follow theory → design → evidence.

Format to IO conventions

• Self-citation / anonymity: IO is double-blind — after the title page, omit self-references that reveal identity and refer to your own work in the third person (e.g., "Matthews 2022," not "as we showed"). Strip identifying file metadata.
• Citations: accepted manuscripts use short author-date footnotes rather than parenthetical references; keep one consistent style (manage with Zotero/BibTeX) and convert at acceptance. The bibliography is excluded from the word count.
• Abstract / word count / acknowledgments: submitted separately from the manuscript; include a Data Availability Statement before the reference list (see io-transparency-and-data-policy).
• ORCID: corresponding author registers an ORCID iD.

Fit the word cap (counts include tables/figures/notes; exclude the bibliography)

• Research Article ≤ 14,000, Research Note ≤ 8,000, Essay ≤ 10,000 words.
• Move balance tables, full specs, robustness grids, and formal-proof details to supplementary material (which should rarely exceed ~20 pages).
• Cut throat-clearing and literature dumps; engage the IR debate, not every paper (see io-literature-positioning).
• Tighten footnotes — they count toward the limit. Prefer one decisive figure to three redundant tables.

The IO introduction, paragraph by paragraph (a working template)

IO introductions that survive the screen tend to follow a recognizable arc. Adapt, don't copy:

1. The puzzle in world politics — a real international phenomenon (why do rivals sign treaties they could defect from?) any IR scholar finds consequential.
2. The live debate and its impasse — the rival accounts and why existing IR theory cannot settle it.
3. The claim — your portable theory of international politics, in one sentence, before any evidence.
4. Design and result in a breath — the dyadic/treaty/experimental setup, the rival it rules out, and the headline magnitude in IR terms (conflict probability, compliance, trade).
5. The stakes — what the field now understands about institutions, cooperation, or conflict that it did not. This is the broad-significance close IO editors look for; a reader from another paradigm should be able to restate the contribution by paragraph three.

Prose register for a methodologically plural IR audience

Because IO mixes formal, quantitative, and qualitative readers, calibrate so none is excluded. A formal result reads better as "states with private information over resolve cannot credibly signal, so bargaining breaks down" before the proposition. A process-tracing narrative should surface its inferential logic so a quantitative reader sees the leverage. The shared standard: the theory of world politics carries the prose and the method serves it.

Anti-patterns

• A single-tradition intro that never states the general IR contribution
• Burying the contribution in the middle of the paper
• First-person self-references that break double-blind anonymity
• Mixed citation styles; acknowledgments left inside the manuscript instead of submitted separately
• Padding a Research Note toward Article length
• Method-led prose where the estimator, not the theory of international politics, drives the narrative

Output format

【IR contribution stated by end of intro?】[Y/N]
【Reads across traditions?】paradigm jargon defined / acronyms spelled? [Y/N]
【Word count】Article ≤14,000 / Note ≤8,000 / Essay ≤10,000 (incl. tables/figures/notes; excl. bibliography)?
【Double-blind】third-person self-citation + metadata clean? [Y/N]
【Abstract/word-count/acknowledgments separate + DAS + ORCID】[Y/N]
【Next】io-transparency-and-data-policy

Supplementary resources

• ../../resources/official-source-map.md — word caps, third-person self-citation, short author-date footnotes, separate abstract/word-count/acknowledgments, ORCID

Source: brycewang-stanford/Awesome-Journal-Skills → International-Organization-Skills/skills/io-writing-style/SKILL.md