Replication Package & Data Policy (wber-replication-package)
When to trigger
- The paper is empirical and headed toward acceptance (or you are building the package early)
- You need to write the data availability statement and the DOI repository link for the title page
- Some data are restricted, proprietary, or governed by a national statistics office and you must plan the deposit around that
- An R&R asks you to make data and code available
- You want to know what "condition of publication" actually requires here
Why this is a WBER signature
WBER's most distinctive, stable policy is transparency as a condition of publication: authors must, where ethically and legally possible, publicly release all data and the software code underlying a published paper. By repute WBER is the only development field journal that routinely publishes data and code, and this fits the broader World Bank reproducible-research push. The manuscript must carry a data availability statement — on the title page / author-affiliation footnote — with a persistent (preferably DOI) link to the data in a repository (检索于 2026-06;以官网为准; verify exact wording on the OUP author guidelines). Build the package as you analyze; do not treat it as an acceptance-day formality.
What the package must contain
| Component |
Requirement |
| Data files |
All data used, in open/documented formats; or, for restricted data, a precise documented access path |
| Analysis + transformation code |
Every script from raw → cleaned data → each table/figure |
| Master script |
One run_all that regenerates every exhibit from raw inputs |
| README |
Data sources, access terms, computational requirements, run instructions, and an exhibit-to-code map |
| Data Availability Statement |
On the title page; persistent DOI link to the repository deposit |
| Instruments |
Survey instruments / enumerator manuals for own-data field studies |
Handling restricted developing-country data
This is the WBER-specific hard part — much development data is governed by national statistics offices, ministries, or data providers (LSMS, DHS, census, tax records):
- You cannot post restricted microdata, but you must still deposit all code and document the exact access procedure: provider, application steps, any cost, approximate wait, and the data version/round used.
- Provide a small synthetic or public extract so the code runs end-to-end and a verifier can check the logic where the real data cannot be shared.
- For DHS/LSMS-type data, cite the specific survey round and version and the registration step a replicator must complete; do not assume "DHS data" is self-locating.
- Declare any restricted-data or exemption situation at the earliest opportunity, not at the final check — arrangements are at editor discretion.
Reproducibility hygiene (build as you go)
- Pin versions: Stata
version + recorded ssc/net package versions; requirements.txt/conda env (Python); renv.lock (R).
- Set and report seeds for every simulation, bootstrap, and randomization-inference step.
- No absolute paths — one root macro/variable; relative paths thereafter.
- Exhibit-to-code map in the README: Table 3 →
code/05_main.do, Figure 2 → code/06_event_study.R.
- Run it clean on a fresh checkout before depositing.
- Currency/PPP transparency: document deflators, PPP conversion factors, and exchange-rate sources — replicators in development work need these to reproduce real-value results.
Adapt the vendored skeleton in ../../resources/code/ (master → clean → descriptive → DiD/IV/RD → mechanism → robustness → tables) as the package backbone.
Checklist
Anti-patterns
- Treating data/code release as optional or as an acceptance-day task — it is a condition of publication
- A title page with no data availability statement or no persistent DOI link
- "DHS/LSMS data" cited with no round, version, or registration path (not reproducible)
- Restricted data with no documented access procedure and no synthetic extract
- Absolute paths, unrecorded package versions, or unset seeds that break reproduction
- Undocumented deflators/PPP factors so real-value results cannot be regenerated
Worked vignette (illustrative)
A poverty paper uses LSMS consumption data (restricted, registration-gated) plus a public price index. The team cannot post the LSMS microdata, so the package contains: every cleaning and analysis script; a README naming the specific LSMS country, round, and version and the exact registration steps a replicator must complete; a small synthetic extract with the same variable structure so run_all executes end-to-end; documented deflators and PPP factors; and pinned Stata package versions with seeds set for the bootstrap. The title page carries a data availability statement with a DOI link to the openICPSR-style deposit holding the code and synthetic data. Because the public price index can be shared, it is deposited in full. The package would let a verifier reproduce the logic, and reproduce the numbers entirely once they obtain LSMS access.
Output format
【Master script】run_all regenerates all exhibits from raw? [Y/N]
【Data】all deposited, or restricted path + synthetic extract? [state]
【DAS + DOI】title-page statement with persistent repository link? [Y/N]
【Survey provenance】DHS/LSMS/admin round + version + access step cited? [Y/N]
【Reproducibility】versions pinned + seeds + no absolute paths + clean run? [Y/N]
【Currency】deflators/PPP/FX documented? [Y/N]
【Restricted/exemption】declared early? [Y/N/NA]
【Next step】wber-referee-strategy
Supplementary resources
1---2name: wber-replication-package3description: Use when assembling the data and code replication package for a The World Bank Economic Review (WBER) manuscript to meet WBER's condition-of-publication data/code release, the data availability statement with a DOI repository link, and the realities of restricted developing-country data. Builds the deposit and README; it does not run the analysis or write the paper.4---56# Replication Package & Data Policy (wber-replication-package)78## When to trigger910- The paper is empirical and headed toward acceptance (or you are building the package early)11- You need to write the data availability statement and the DOI repository link for the title page12- Some data are restricted, proprietary, or governed by a national statistics office and you must plan the deposit around that13- An R&R asks you to make data and code available14- You want to know what "condition of publication" actually requires here1516## Why this is a WBER signature1718WBER's most distinctive, stable policy is **transparency as a condition of publication**: authors must, where ethically and legally possible, **publicly release all data and the software code** underlying a published paper. By repute WBER is the only development *field* journal that routinely publishes data and code, and this fits the broader World Bank reproducible-research push. The manuscript must carry a **data availability statement** — on the title page / author-affiliation footnote — with a **persistent (preferably DOI) link** to the data in a repository (检索于 2026-06;以官网为准; verify exact wording on the OUP author guidelines). Build the package as you analyze; do not treat it as an acceptance-day formality.1920## What the package must contain2122| Component | Requirement |23|-----------|-------------|24| **Data files** | All data used, in open/documented formats; or, for restricted data, a precise documented access path |25| **Analysis + transformation code** | Every script from raw → cleaned data → each table/figure |26| **Master script** | One `run_all` that regenerates every exhibit from raw inputs |27| **README** | Data sources, access terms, computational requirements, run instructions, and an exhibit-to-code map |28| **Data Availability Statement** | On the title page; persistent DOI link to the repository deposit |29| **Instruments** | Survey instruments / enumerator manuals for own-data field studies |3031## Handling restricted developing-country data3233This is the WBER-specific hard part — much development data is governed by national statistics offices, ministries, or data providers (LSMS, DHS, census, tax records):3435- You **cannot** post restricted microdata, but you **must** still deposit all code and document the exact access procedure: provider, application steps, any cost, approximate wait, and the data version/round used.36- Provide a small **synthetic or public extract** so the code runs end-to-end and a verifier can check the logic where the real data cannot be shared.37- For DHS/LSMS-type data, cite the **specific survey round and version** and the registration step a replicator must complete; do not assume "DHS data" is self-locating.38- Declare any **restricted-data or exemption situation at the earliest opportunity**, not at the final check — arrangements are at editor discretion.3940## Reproducibility hygiene (build as you go)4142- **Pin versions:** Stata `version` + recorded `ssc`/`net` package versions; `requirements.txt`/conda env (Python); `renv.lock` (R).43- **Set and report seeds** for every simulation, bootstrap, and randomization-inference step.44- **No absolute paths** — one root macro/variable; relative paths thereafter.45- **Exhibit-to-code map** in the README: Table 3 → `code/05_main.do`, Figure 2 → `code/06_event_study.R`.46- **Run it clean** on a fresh checkout before depositing.47- **Currency/PPP transparency:** document deflators, PPP conversion factors, and exchange-rate sources — replicators in development work need these to reproduce real-value results.4849> Adapt the vendored skeleton in [`../../resources/code/`](../../resources/code/) (master → clean → descriptive → DiD/IV/RD → mechanism → robustness → tables) as the package backbone.5051## Checklist5253- [ ] One `run_all` master script regenerates every table and figure from raw data54- [ ] All data deposited (or restricted-data access path documented + synthetic/public extract provided)55- [ ] README has a complete exhibit-to-code map and computational requirements56- [ ] Data Availability Statement on the title page with a persistent DOI repository link57- [ ] Specific survey rounds/versions (DHS/LSMS/census/admin) cited with the registration step58- [ ] Software/package versions pinned; seeds set and reported; no absolute paths59- [ ] Deflators / PPP / exchange-rate sources documented60- [ ] Restricted-data / exemption situation declared early; field instruments included6162## Anti-patterns6364- Treating data/code release as optional or as an acceptance-day task — it is a condition of publication65- A title page with no data availability statement or no persistent DOI link66- "DHS/LSMS data" cited with no round, version, or registration path (not reproducible)67- Restricted data with no documented access procedure and no synthetic extract68- Absolute paths, unrecorded package versions, or unset seeds that break reproduction69- Undocumented deflators/PPP factors so real-value results cannot be regenerated7071## Worked vignette (illustrative)7273A poverty paper uses LSMS consumption data (restricted, registration-gated) plus a public price index. The team cannot post the LSMS microdata, so the package contains: every cleaning and analysis script; a README naming the **specific LSMS country, round, and version** and the exact registration steps a replicator must complete; a small **synthetic extract** with the same variable structure so `run_all` executes end-to-end; documented deflators and PPP factors; and pinned Stata package versions with seeds set for the bootstrap. The title page carries a data availability statement with a DOI link to the openICPSR-style deposit holding the code and synthetic data. Because the public price index *can* be shared, it is deposited in full. The package would let a verifier reproduce the logic, and reproduce the numbers entirely once they obtain LSMS access.7475## Output format7677```text78【Master script】run_all regenerates all exhibits from raw? [Y/N]79【Data】all deposited, or restricted path + synthetic extract? [state]80【DAS + DOI】title-page statement with persistent repository link? [Y/N]81【Survey provenance】DHS/LSMS/admin round + version + access step cited? [Y/N]82【Reproducibility】versions pinned + seeds + no absolute paths + clean run? [Y/N]83【Currency】deflators/PPP/FX documented? [Y/N]84【Restricted/exemption】declared early? [Y/N/NA]85【Next step】wber-referee-strategy86```8788## Supplementary resources8990- [`../../resources/code/`](../../resources/code/) — reproducible Stata + Python skeleton to adapt as the package backbone91- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — official OUP / WBER URLs behind the data policy