How to contribute

DAGpedia grows through community contribution. Every DAG strengthens shared epistemic infrastructure for causal inference in epidemiology.

This page is a visitor-friendly entry point. The full contributor guide with validation commands and review criteria lives in the repository.

Quick start

1. Propose work on GitHub

   • New DAG issue — submit a causal diagram
   • New Node issue — add a variable to the controlled vocabulary

2. Read the full guide — docs/CONTRIBUTING.md

3. Fork, branch, and open a PR against main

Two-layer content (summary)

Layer	Path	You edit?
Markdown source	src/content/dags/<id>.md	Yes
Generated JSON	_data/<id>.json	No (CI only)

Copy _templates/dag-template.md to src/content/dags/your-dag-id.md. Register new node keys in src/content/nodes/ in a separate PR before using them in dagitty.

Validation

python scripts/nodes/validate_nodes.py --all
python scripts/dag/validate_dag.py src/content/dags/your-dag-id.md
npm run generate-dag-data
npm run build

Schema and enums: docs/schema/README.md

Workflow docs

• Issue → DAG workflow
• PR and review
• Using the validator

Review expectations

• Valid DAGitty syntax and schema compliance
• evidence keys match dagitty edges exactly
• Clear narrative and explicit assumptions

We do not require universal agreement on causal structure — assumptions must be stated, not hidden.