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
Source: brycewang-stanford/Awesome-Journal-Skills → Social-Forces-Skills/skills/sf-data-and-transparency/SKILL.md
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.4---567# Data & Transparency (sf-data-and-transparency)89Social Forces makes one transparency requirement explicit: **"The inclusion of a data availability10statement is a requirement for papers published in the Journal."** Unlike journals that run an11editor-verified pre-publication replication, SF asks for a clear **statement** plus deposit **where12ethically feasible**. Treat the statement as a real deliverable and build the materials as you go so it13is honest and complete.1415## When to trigger1617- Drafting the **data availability statement** (required for publication)18- Deciding where and how to deposit data and code19- Data cannot be fully shared (privacy, ethics, legal/provider restrictions) and you need the right wording20- Documenting qualitative or restricted sources to support the claims2122## What SF requires (verify current wording on the policy page)23241. **Data availability statement.** Every published paper carries one. It should describe whether and25 how the data underlying the results are available — repository name, persistent identifier or26 accession number, or the access process for restricted data.272. **Deposit where ethically feasible.** Authors are encouraged to deposit data (and ideally analysis28 code) in a **public repository** with persistent identifiers — e.g., openICPSR, Harvard Dataverse,29 OSF, Zenodo. This is encouraged, not a journal-run verification step (待核实 on any evolving policy).303. **Documentation that supports reproducibility.** A master script + README + pinned versions + seeds,31 so the reported tables and figures can in principle be regenerated.3233## When data cannot be shared (restricted-data path)3435- **Explain why** in the statement (ethical/privacy concerns or legal restrictions by the provider).36- Give **access instructions**: the application/enclave process and provider contact, so a reader could37 in principle obtain the same data.38- Where possible, provide **synthetic or simulated data** so the code can be run end to end.3940## Qualitative / restricted transparency4142- Document interviews, fieldnotes, and archival sources in a form that supports the claims (evidence43 tables, annotated sources), with access controls where confidentiality requires them.44- Consent should cover **publication of the data**, and identifying details should be anonymized.4546## Build-as-you-go checklist4748- [ ] **Data availability statement** drafted (availability + identifier/accession or access process)49- [ ] One **master script** regenerates **every** table and figure from raw/constructed data50- [ ] **README** documents provenance, construction steps, and how to reproduce each exhibit51- [ ] **Seeds** set and reported; software/package **versions pinned**52- [ ] Restricted data: reason + access path + synthetic substitute where feasible53- [ ] Exhibit numbers in the manuscript **match** the deposited/declared materials5455## Anti-patterns5657- Writing the data availability statement as a one-line afterthought at proofs58- Saying "data available on request" with no repository, identifier, or real process59- Claiming data are restricted without giving an access path or synthetic substitute60- Depositing code that does not actually reproduce the reported tables/figures61- Over-stating SF's policy as an editor-run replication mandate when it is a statement + encouraged deposit6263## Choosing the right data-availability path6465Social Forces spans survey, administrative, demographic, qualitative, and restricted-access data, so the66statement has to match the data type honestly. A routing table:6768| Data situation | Statement should say | Repository / mechanism |69|----------------|----------------------|------------------------|70| Public survey (GSS/PSID style) | Where to download + wave | Cite source; deposit construction code |71| Author-collected, shareable | Deposited with persistent ID | openICPSR, Dataverse, OSF, Zenodo |72| Restricted administrative | Why restricted + enclave path | Provider process; synthetic substitute |73| Qualitative / interviews | What is documented + consent limits | Evidence tables; access controls |7475Calibration (hedged): SF requires a data availability statement and encourages deposit where ethically76feasible — not an editor-run pre-publication replication. Confirm wording against current guidelines.7778## Worked vignette (illustrative)7980A panel study of educational stratification links restricted administrative records to a public survey.81The honest statement names the public survey and wave (downloadable), notes the linked records are82reachable only through the provider's secure enclave with the application contact, and points to a83synthetic analytic file plus master script on OSF so a reader can run the pipeline end to end — public84where possible, a documented access path where not, a runnable substitute throughout.8586Referee fixes: "'available on request' is not enough" → name a repository or access process;87"code does not reproduce Table 3" → ship a master script that regenerates every declared exhibit.8889## Output format9091```92【Data availability statement】drafted? availability + identifier/access path? [Y/N]93【Deposit】public repository + persistent ID (where feasible)? [Y/N/NA]94【Reproduces tables/figures?】master script verified locally? [Y/N]95【Documentation】README + provenance + seeds + pinned versions? [Y/N]96【Restricted data?】reason + access path + synthetic data?97【Next】sf-review-process98```99100## Supplementary resources101102- [`../../resources/external_tools.md`](../../resources/external_tools.md) — repositories, reproducibility tooling, qualitative-transparency options103- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — data availability statement requirement and deposit encouragement104105---106107**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `Social-Forces-Skills/skills/sf-data-and-transparency/SKILL.md`
thedixitjain