← Back to home Contribution guide

Contribute to Iran.md

This project moves forward on careful articles, transparent sources, and multiple voices. Every new article, every sourcing fix, and every reported issue matters.

Complete frontmatter Direct source links Run the four core checks before a PR

Write a new article

Pick a topic we haven't covered yet. Gather direct sources, and send a documented, bias-free article.

Improve an existing article

Add a stronger source, build the English counterpart, or rewrite a section to be clearer and more accurate.

Report an issue

Found a factual error, a weak source, or hidden bias? Open a GitHub issue. No code required.

Workflow

From idea to pull request

  1. Read the editorial guide so tone, article structure, and sourcing rules are clear.
  2. If you're writing a new article, create a file under knowledge/fa/ (or knowledge/en/) and fill in the frontmatter before writing any body prose.
  3. Use direct links for every source -- article, paper, or archive page -- not the organization's homepage.
  4. For flagship articles, fill in extended_summary so readers get the short version too.
  5. Before opening a PR, run four commands: npm run lint:persian, npm run check:sources, npm run test, and npm run build.
  6. Open the PR. For sensitive topics, explain your sourcing and structure decisions in the description.
Sources and editorial voice

Minimum expectations for sources and prose

On sensitive topics, multi-voice reporting beats flattening. Where there's no consensus, or the data is incomplete, the article should say so -- not pretend.

  • Every source entry should include title, url, access_date, type, and language.
  • Sensitive categories in history, society, and people require at least two sources.
  • When good Persian and English sources both exist, include both.
  • Wikipedia can help orient research, but it should not dominate the sourcing stack.
  • The opening sentence should define the subject directly, and headings should stay descriptive.
  • On contested topics, present at least two perspectives in the same tone, each with its own sources.
Work queues

Where contributions matter most right now

Missing anchor articles

Each category needs at least one strong flagship article so category pages aren't just placeholders.

English counterparts

Published Persian articles gain much more value with restrained, source-aware English partners.

Source strengthening

Generic institutional or homepage links should be replaced with deeper, more specific references.

Article polish

Long paragraphs, vague summaries, and thin section openings still need editorial tightening.

Pseudonymous contributions are welcome.

No one is required to reveal a real identity. For sensitive topics, contributor safety matters more than public attribution.

Open an issue Open repository