forrtproject / forrtproject/replication-handbook

[MetaROR] Cross-cutting editorial changes

Open
#24 0 comments 0 reactions 0 assignees View on GitHub
metaror-review
Dominant language
TeX
Stars
3
Forks
0
PR merge metrics
No merged PRs in 30d

Description

Editorial changes that span the whole handbook, raised by multiple MetaROR reviewers (R1, R2, R3). These need consistent treatment across chapters written by different contributors.

- [ ] **Align terminology and typologies across chapters** — reconcile inconsistent terms for the same concepts (e.g. "numerical reproduction" vs "computational reproduction", "recreate reproduction" vs "recoding reproduction") and the overlapping typologies in Table 4.1, Figure 4.1, Figure 4.2, Sections 2.3/2.4 and Chapter 7. (R1, R2, R3)
- [ ] **Ensure chapters relate to each other more clearly** — sections feel siloed; add cross-references and a consistent framing across contributors. (R1, R2, R3)
- [ ] **Integrate the deductive vs inductive framework throughout** — connect Section 2 to Section 6.3 (changes in methods), Section 7.2 (interpreting divergent results), Figure 2.1, and the hidden-moderators discussion. (R1, R3) — chapter-specific edits are tracked in the Chapter 6 and Chapter 7 issues.
- [ ] **Clarify the target audience** — researchers new to empirical research generally, or specifically those new to replication/reproduction? This affects depth and scope throughout. (R2, R3)
- [ ] **Add a constraints-on-generality discussion** — engage the Simons et al. (2017) CoG framework substantively, linking to WEIRD sampling and contextual sensitivity (Section 2.3); currently only briefly mentioned in Section 6.3. (R1, R2)
- [ ] **Expand the preregistration discussion consistently** — clarify whether referring to preregistering the reproduction/replication itself or targeting preregistered studies, and treat deviations from preregistration consistently across Chapters 5 and 6. (R1, R2) — the angle/space decision is tracked in *Points for discussion*.
- [ ] **Expand the use of real-life examples** — the handbook is strongest when discussing actual replication cases; add more practical, worked examples throughout. (R1, R3)

**Related existing issues** (whoever takes this owns these too):
- #9 List of changes that need to be reviewed by all contributors
- #7 Revise introductory chapters based on Breznau et al.'s Teaching Companion

**Handled in other issues:**
- Use "this handbook" consistently; add per-section introductory lines → *Final formatting, consistency & referencing*

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing related issues #9 and #7, then map the terminology and frameworks across Sections 2.3/2.4, 6.3, 7.2, Chapter 7, and Tables 4.1 and Figures 2.1, 4.1, and 4.2. Check the Points for discussion and Chapter 6 and 7 issues before editing. Done means consistent terminology, framing, audience, preregistration treatment, constraints-on-generality discussion, and practical examples across the handbook.

Written by the indexing model from the issue text.

Assessment

Tech stack
tex
Domain
content, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.