Data & Transparency (sf-data-and-transparency)
Social Forces makes one transparency requirement explicit: "The inclusion of a data availability
statement is a requirement for papers published in the Journal." Unlike journals that run an
editor-verified pre-publication replication, SF asks for a clear statement plus deposit where
ethically feasible. Treat the statement as a real deliverable and build the materials as you go so it
is honest and complete.
When to trigger
- Drafting the data availability statement (required for publication)
- Deciding where and how to deposit data and code
- Data cannot be fully shared (privacy, ethics, legal/provider restrictions) and you need the right wording
- Documenting qualitative or restricted sources to support the claims
What SF requires (verify current wording on the policy page)
- Data availability statement. Every published paper carries one. It should describe whether and
how the data underlying the results are available — repository name, persistent identifier or
accession number, or the access process for restricted data.
- Deposit where ethically feasible. Authors are encouraged to deposit data (and ideally analysis
code) in a public repository with persistent identifiers — e.g., openICPSR, Harvard Dataverse,
OSF, Zenodo. This is encouraged, not a journal-run verification step (待核实 on any evolving policy).
- Documentation that supports reproducibility. A master script + README + pinned versions + seeds,
so the reported tables and figures can in principle be regenerated.
When data cannot be shared (restricted-data path)
- Explain why in the statement (ethical/privacy concerns or legal restrictions by the provider).
- Give access instructions: the application/enclave process and provider contact, so a reader could
in principle obtain the same data.
- Where possible, provide synthetic or simulated data so the code can be run end to end.
Qualitative / restricted transparency
- Document interviews, fieldnotes, and archival sources in a form that supports the claims (evidence
tables, annotated sources), with access controls where confidentiality requires them.
- Consent should cover publication of the data, and identifying details should be anonymized.
Build-as-you-go checklist
Anti-patterns
- Writing the data availability statement as a one-line afterthought at proofs
- Saying "data available on request" with no repository, identifier, or real process
- Claiming data are restricted without giving an access path or synthetic substitute
- Depositing code that does not actually reproduce the reported tables/figures
- Over-stating SF's policy as an editor-run replication mandate when it is a statement + encouraged deposit
Choosing the right data-availability path
Social Forces spans survey, administrative, demographic, qualitative, and restricted-access data, so the
statement has to match the data type honestly. A routing table:
| Data situation |
Statement should say |
Repository / mechanism |
| Public survey (GSS/PSID style) |
Where to download + wave |
Cite source; deposit construction code |
| Author-collected, shareable |
Deposited with persistent ID |
openICPSR, Dataverse, OSF, Zenodo |
| Restricted administrative |
Why restricted + enclave path |
Provider process; synthetic substitute |
| Qualitative / interviews |
What is documented + consent limits |
Evidence tables; access controls |
Calibration (hedged): SF requires a data availability statement and encourages deposit where ethically
feasible — not an editor-run pre-publication replication. Confirm wording against current guidelines.
Worked vignette (illustrative)
A panel study of educational stratification links restricted administrative records to a public survey.
The honest statement names the public survey and wave (downloadable), notes the linked records are
reachable only through the provider's secure enclave with the application contact, and points to a
synthetic analytic file plus master script on OSF so a reader can run the pipeline end to end — public
where possible, a documented access path where not, a runnable substitute throughout.
Referee fixes: "'available on request' is not enough" → name a repository or access process;
"code does not reproduce Table 3" → ship a master script that regenerates every declared exhibit.
Output format
【Data availability statement】drafted? availability + identifier/access path? [Y/N]
【Deposit】public repository + persistent ID (where feasible)? [Y/N/NA]
【Reproduces tables/figures?】master script verified locally? [Y/N]
【Documentation】README + provenance + seeds + pinned versions? [Y/N]
【Restricted data?】reason + access path + synthetic data?
【Next】sf-review-process
Supplementary resources
1---2name: sf-data-and-transparency3description: Use when preparing the data, code, and transparency materials for a Social Forces (SF) manuscript. SF requires a data availability statement on every published paper and encourages deposit in a public repository where ethically feasible. Covers quantitative and qualitative transparency and restricted-data paths; it does not waive requirements.4metadata:5 source: https://skillmd.com/skills/brycewang-stanford/sf-data-and-transparency6---78# Data & Transparency (sf-data-and-transparency)910Social Forces makes one transparency requirement explicit: **"The inclusion of a data availability11statement is a requirement for papers published in the Journal."** Unlike journals that run an12editor-verified pre-publication replication, SF asks for a clear **statement** plus deposit **where13ethically feasible**. Treat the statement as a real deliverable and build the materials as you go so it14is honest and complete.1516## When to trigger1718- Drafting the **data availability statement** (required for publication)19- Deciding where and how to deposit data and code20- Data cannot be fully shared (privacy, ethics, legal/provider restrictions) and you need the right wording21- Documenting qualitative or restricted sources to support the claims2223## What SF requires (verify current wording on the policy page)24251. **Data availability statement.** Every published paper carries one. It should describe whether and26 how the data underlying the results are available — repository name, persistent identifier or27 accession number, or the access process for restricted data.282. **Deposit where ethically feasible.** Authors are encouraged to deposit data (and ideally analysis29 code) in a **public repository** with persistent identifiers — e.g., openICPSR, Harvard Dataverse,30 OSF, Zenodo. This is encouraged, not a journal-run verification step (待核实 on any evolving policy).313. **Documentation that supports reproducibility.** A master script + README + pinned versions + seeds,32 so the reported tables and figures can in principle be regenerated.3334## When data cannot be shared (restricted-data path)3536- **Explain why** in the statement (ethical/privacy concerns or legal restrictions by the provider).37- Give **access instructions**: the application/enclave process and provider contact, so a reader could38 in principle obtain the same data.39- Where possible, provide **synthetic or simulated data** so the code can be run end to end.4041## Qualitative / restricted transparency4243- Document interviews, fieldnotes, and archival sources in a form that supports the claims (evidence44 tables, annotated sources), with access controls where confidentiality requires them.45- Consent should cover **publication of the data**, and identifying details should be anonymized.4647## Build-as-you-go checklist4849- [ ] **Data availability statement** drafted (availability + identifier/accession or access process)50- [ ] One **master script** regenerates **every** table and figure from raw/constructed data51- [ ] **README** documents provenance, construction steps, and how to reproduce each exhibit52- [ ] **Seeds** set and reported; software/package **versions pinned**53- [ ] Restricted data: reason + access path + synthetic substitute where feasible54- [ ] Exhibit numbers in the manuscript **match** the deposited/declared materials5556## Anti-patterns5758- Writing the data availability statement as a one-line afterthought at proofs59- Saying "data available on request" with no repository, identifier, or real process60- Claiming data are restricted without giving an access path or synthetic substitute61- Depositing code that does not actually reproduce the reported tables/figures62- Over-stating SF's policy as an editor-run replication mandate when it is a statement + encouraged deposit6364## Choosing the right data-availability path6566Social Forces spans survey, administrative, demographic, qualitative, and restricted-access data, so the67statement has to match the data type honestly. A routing table:6869| Data situation | Statement should say | Repository / mechanism |70|----------------|----------------------|------------------------|71| Public survey (GSS/PSID style) | Where to download + wave | Cite source; deposit construction code |72| Author-collected, shareable | Deposited with persistent ID | openICPSR, Dataverse, OSF, Zenodo |73| Restricted administrative | Why restricted + enclave path | Provider process; synthetic substitute |74| Qualitative / interviews | What is documented + consent limits | Evidence tables; access controls |7576Calibration (hedged): SF requires a data availability statement and encourages deposit where ethically77feasible — not an editor-run pre-publication replication. Confirm wording against current guidelines.7879## Worked vignette (illustrative)8081A panel study of educational stratification links restricted administrative records to a public survey.82The honest statement names the public survey and wave (downloadable), notes the linked records are83reachable only through the provider's secure enclave with the application contact, and points to a84synthetic analytic file plus master script on OSF so a reader can run the pipeline end to end — public85where possible, a documented access path where not, a runnable substitute throughout.8687Referee fixes: "'available on request' is not enough" → name a repository or access process;88"code does not reproduce Table 3" → ship a master script that regenerates every declared exhibit.8990## Output format9192```93【Data availability statement】drafted? availability + identifier/access path? [Y/N]94【Deposit】public repository + persistent ID (where feasible)? [Y/N/NA]95【Reproduces tables/figures?】master script verified locally? [Y/N]96【Documentation】README + provenance + seeds + pinned versions? [Y/N]97【Restricted data?】reason + access path + synthetic data?98【Next】sf-review-process99```100101## Supplementary resources102103- [`../../resources/external_tools.md`](../../resources/external_tools.md) — repositories, reproducibility tooling, qualitative-transparency options104- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — data availability statement requirement and deposit encouragement