Transparency & Data Policy (jmf-transparency-and-data-policy)
JMF expects enough detail on design and procedures to facilitate replication, and Wiley applies a
data-sharing policy requiring a Data Availability Statement for research and synthesis articles. Many family datasets
(PSID, Add Health, Fragile Families, NSFG) are restricted-use and cannot be redistributed — so plan
transparency around access, not redistribution. Live-check the current JMF/Wiley wording before upload.
When to trigger
- Building the reproducibility/replication and data-availability materials
- Writing the data availability statement for the manuscript
- Your data are restricted-use and cannot be posted
- A replication submission (materials expectations are central)
What JMF / Wiley expect
- Replication-level detail. The Method and any supplements describe the sample derivation,
measures, coding, and analytic approach in enough detail that a competent reader could reproduce
the study. Brief reports are explicitly welcomed for replications and important null findings.
- Data availability statement. Wiley's data-sharing policy requires a statement in research and
synthesis articles confirming whether data are shared and how they can be accessed; check whether
JMF adds journal-specific wording at upload.
- Analysis code. Deposit code that regenerates the reported tables and figures in an approved
repository (e.g., OSF, ICPSR, Harvard Dataverse) where data terms allow. Master script +
README + pinned versions + seeds.
- Qualitative materials. Share what the data terms and human-subjects protections allow (e.g.,
coding schemes, excerpts, evidence tables), with access controls where needed; do not expose
identifiable family information.
Restricted-use family data (the common case)
- State the restriction and who imposes it (e.g., data-provider agreement, IRB, privacy of minors).
- Provide README instructions on exactly how others obtain the data (application process, provider
contact, required agreements) so the analysis is reproducible by an authorized user.
- Where feasible, provide synthetic or derived data plus full code so the pipeline can be run.
- Cite the dataset and version precisely (DOI/release) so reviewers know exactly what you used.
Build-as-you-go checklist
Transparency expectations by data type at JMF
| Data type |
What can be shared |
Access path to document |
Common trap |
| Public-use survey (e.g., some NSFG files) |
Constructed analytic code + variable derivations |
Cite dataset DOI/release; link repository |
Posting a redistributable file you re-shaped without the version |
| Restricted-use panel (PSID, Add Health, Fragile Families) |
Code + README; not the raw data |
Application/agreement steps so an authorized user reproduces |
"Available on request" with no access route |
| Couple/dyadic micro-data |
De-identified derived measures where terms allow |
Provider contact + agreement |
Re-identifiable couples or children in shared excerpts |
| Qualitative family interviews |
Coding scheme, evidence tables, masked excerpts |
Access controls per IRB/consent |
Exposing identifying family detail |
For the flagship journal of family science, the Wiley data-sharing policy and a data availability statement
sit alongside JMF's expectation of replication-level methodological detail. Because so many family datasets
are restricted-use, transparency at JMF is engineered around documented access, not redistribution.
Worked micro-example (illustrative)
A divorce-timing paper uses restricted PSID-linked data that cannot be posted. The transparency package:
(1) a data availability statement reading, in effect, "Data are from the Panel Study of Income Dynamics
(release YYYY) and are restricted-use; access requires a PSID sensitive-data agreement — see README for the
application steps"; (2) a master script that regenerates all six tables and two figures from the
constructed file, with seeds fixed for the multiple-imputation and bootstrap steps; (3) a synthetic dataset
of the same schema so a reader without the agreement can run the pipeline end-to-end and confirm it
executes; (4) precise dataset citation with release/version. The release year and agreement name here are
illustrative placeholders to confirm against the provider.
Referee/editor-facing pitfalls and the fix
- "How would anyone reproduce this?" Replace "available on request" with the concrete application process,
provider contact, and required agreements for the restricted family dataset.
- "Code doesn't reproduce the printed tables." Ship one master script that builds every exhibit, plus
pinned package versions (
renv.lock/requirements.txt) and recorded seeds.
- "Qualitative materials would identify families." Share coding schemes and masked evidence tables under
access controls rather than raw transcripts.
Calibration anchors (hedged where uncertain)
- That JMF expects replication-level detail and that Wiley requires a Data Availability Statement are
stable features; live-check whether the JMF upload workflow adds journal-specific wording or
repository expectations beyond Wiley's general policy.
- Brief reports are an established channel for replications and important null findings, which raises the
premium on a clean reproducibility package; treat this as a venue norm to verify, not a quota.
Anti-patterns
- Treating transparency as a post-acceptance afterthought
- A vague "data available on request" with no access path for restricted family data
- Posting identifiable information about couples, children, or families
- Code that does not actually reproduce the printed tables/figures
- Undocumented, un-seeded, unpinned code that "works on my machine"
Output format
【Replication detail】sample/measures/coding documented? [Y/N]
【Data availability statement】shared / restricted + access path drafted? [Y/N]
【Code deposit】master script reproduces tables/figures (OSF/ICPSR/Dataverse)? [Y/N]
【Restricted data】restriction note + access instructions + synthetic data?
【Qualitative transparency】materials documented within human-subjects limits? [Y/N/NA]
【Next】jmf-review-process
Supplementary resources
1---2name: jmf-transparency-and-data-policy3description: Use when preparing the reproducibility / replication and data-sharing materials for a Journal of Marriage and Family (JMF) manuscript. JMF asks for replication-level detail and Wiley applies a data-sharing policy with a data availability statement; many family datasets are restricted-use. Covers quantitative and qualitative transparency and the restricted-data path. Prepares the package; it does not waive requirements.4metadata:5 source: https://skillmd.com/skills/brycewang-stanford/jmf-transparency-and-data-policy6---78# Transparency & Data Policy (jmf-transparency-and-data-policy)910JMF expects enough detail on design and procedures to **facilitate replication**, and Wiley applies a11**data-sharing policy** requiring a **Data Availability Statement** for research and synthesis articles. Many family datasets12(PSID, Add Health, Fragile Families, NSFG) are **restricted-use** and cannot be redistributed — so plan13transparency around *access*, not redistribution. Live-check the current JMF/Wiley wording before upload.1415## When to trigger1617- Building the reproducibility/replication and data-availability materials18- Writing the **data availability statement** for the manuscript19- Your data are **restricted-use** and cannot be posted20- A **replication** submission (materials expectations are central)2122## What JMF / Wiley expect23241. **Replication-level detail.** The Method and any supplements describe the sample derivation,25 measures, coding, and analytic approach in enough detail that a competent reader could reproduce26 the study. Brief reports are explicitly welcomed for **replications** and **important null findings**.272. **Data availability statement.** Wiley's data-sharing policy requires a statement in research and28 synthesis articles confirming whether data are shared and how they can be accessed; check whether29 JMF adds journal-specific wording at upload.303. **Analysis code.** Deposit code that regenerates the reported tables and figures in an approved31 repository (e.g., **OSF**, **ICPSR**, Harvard Dataverse) where data terms allow. Master script +32 README + pinned versions + seeds.334. **Qualitative materials.** Share what the data terms and human-subjects protections allow (e.g.,34 coding schemes, excerpts, evidence tables), with access controls where needed; do not expose35 identifiable family information.3637## Restricted-use family data (the common case)3839- **State the restriction** and who imposes it (e.g., data-provider agreement, IRB, privacy of minors).40- Provide **README instructions on exactly how others obtain the data** (application process, provider41 contact, required agreements) so the analysis is reproducible by an authorized user.42- Where feasible, provide **synthetic or derived data** plus full code so the pipeline can be run.43- Cite the dataset and version precisely (DOI/release) so reviewers know exactly what you used.4445## Build-as-you-go checklist4647- [ ] One **master script** regenerates **every** table and figure from raw/constructed data48- [ ] **README** documents data provenance, sample derivation, and how to reproduce each exhibit49- [ ] **Seeds** set and reported for imputation, bootstrap, and stochastic steps50- [ ] Software/package **versions pinned** (`renv.lock` / `requirements.txt` / recorded installs)51- [ ] **Data availability statement** drafted (shared / restricted + access path)52- [ ] Restricted data: restriction note + access instructions + synthetic data where feasible53- [ ] Preregistration / pre-analysis plan linked (anonymized) where applicable5455## Transparency expectations by data type at JMF5657| Data type | What can be shared | Access path to document | Common trap |58|-----------|--------------------|--------------------------|-------------|59| Public-use survey (e.g., some NSFG files) | Constructed analytic code + variable derivations | Cite dataset DOI/release; link repository | Posting a redistributable file you re-shaped without the version |60| Restricted-use panel (PSID, Add Health, Fragile Families) | Code + README; not the raw data | Application/agreement steps so an authorized user reproduces | "Available on request" with no access route |61| Couple/dyadic micro-data | De-identified derived measures where terms allow | Provider contact + agreement | Re-identifiable couples or children in shared excerpts |62| Qualitative family interviews | Coding scheme, evidence tables, masked excerpts | Access controls per IRB/consent | Exposing identifying family detail |6364For the flagship journal of family science, the Wiley data-sharing policy and a data availability statement65sit alongside JMF's expectation of replication-level methodological detail. Because so many family datasets66are restricted-use, transparency at JMF is engineered around *documented access*, not redistribution.6768## Worked micro-example (illustrative)6970A divorce-timing paper uses restricted PSID-linked data that cannot be posted. The transparency package:71(1) a data availability statement reading, in effect, "Data are from the Panel Study of Income Dynamics72(release YYYY) and are restricted-use; access requires a PSID sensitive-data agreement — see README for the73application steps"; (2) a master script that regenerates all six tables and two figures from the74constructed file, with seeds fixed for the multiple-imputation and bootstrap steps; (3) a synthetic dataset75of the same schema so a reader without the agreement can run the pipeline end-to-end and confirm it76executes; (4) precise dataset citation with release/version. The release year and agreement name here are77illustrative placeholders to confirm against the provider.7879## Referee/editor-facing pitfalls and the fix8081- *"How would anyone reproduce this?"* Replace "available on request" with the concrete application process,82 provider contact, and required agreements for the restricted family dataset.83- *"Code doesn't reproduce the printed tables."* Ship one master script that builds every exhibit, plus84 pinned package versions (`renv.lock`/`requirements.txt`) and recorded seeds.85- *"Qualitative materials would identify families."* Share coding schemes and masked evidence tables under86 access controls rather than raw transcripts.8788## Calibration anchors (hedged where uncertain)8990- That JMF expects replication-level detail and that Wiley requires a Data Availability Statement are91 stable features; live-check whether the JMF upload workflow adds journal-specific wording or92 repository expectations beyond Wiley's general policy.93- Brief reports are an established channel for replications and important null findings, which raises the94 premium on a clean reproducibility package; treat this as a venue norm to verify, not a quota.9596## Anti-patterns9798- Treating transparency as a post-acceptance afterthought99- A vague "data available on request" with no access path for restricted family data100- Posting identifiable information about couples, children, or families101- Code that does not actually reproduce the printed tables/figures102- Undocumented, un-seeded, unpinned code that "works on my machine"103104## Output format105106```107【Replication detail】sample/measures/coding documented? [Y/N]108【Data availability statement】shared / restricted + access path drafted? [Y/N]109【Code deposit】master script reproduces tables/figures (OSF/ICPSR/Dataverse)? [Y/N]110【Restricted data】restriction note + access instructions + synthetic data?111【Qualitative transparency】materials documented within human-subjects limits? [Y/N/NA]112【Next】jmf-review-process113```114115## Supplementary resources116117- [`../../resources/external_tools.md`](../../resources/external_tools.md) — repositories, reproducibility tooling, and restricted-data handling118- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — Wiley data-sharing policy and JMF replication guidance