Io Writing Style

---
name: io-writing-style
description: Use when drafting or polishing an International Organization (IO) manuscript so it reads for international-relations scholars across paradigms, fits the word caps (Research Article <= 14,000; Research Note <= 8,000; Essay <= 10,000, including tables, figures, and notes but excluding the bibliography), and meets IO format conventions (double-blind, third-person self-citation, short author-date footnotes, separate abstract/word-count/acknowledgments). Tightens prose and format; it does not invent content.
---

# 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.

## 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

## 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`](../../resources/official-source-map.md) — word caps, third-person self-citation, short author-date footnotes, separate abstract/word-count/acknowledgments, ORCID