Repository Public Research preview
1# Templates23Fill every bracket from the manuscript or delete the line. Never leave an invented example4in a report. `node scripts/manuscript.mjs scaffold <file>` produces the referee report5skeleton with the audit findings already placed.67## Intake note89```markdown10Manuscript: [title]11Version: [commit, checksum or date of the main file]12Files read: [main file, included files, bibliography, supplement]13Not provided: [figures as images only, data, code, appendix ...]14Request: [referee report | pre-submission check | editor assessment | revision check]15Venue, field: [if known]16Audit: [n errors, n warnings, n notes; includes not read: none | list]17```1819## Referee report2021```markdown22# Referee report2324Manuscript: [title]25Version reviewed: [version]26Date: [date]2728## Summary of the submission2930[Three to five sentences the authors would accept as fair: the question, the data and31method, the main result, the claimed contribution.]3233## Overall assessment3435[One paragraph: what is convincing, what is not, and what the recommendation turns on.]3637## Strengths38391. [Specific, with location.]4041## Major comments42431. **[Short title.]** [What is wrong or not shown, quoting the manuscript.]44 Where: [section, exhibit, file:line]45 Why it matters: [which conclusion depends on it]46 What would resolve it: [analysis, clarification or narrower claim]47 Status: [confirmed | not shown]4849## Minor comments5051[Grouped by section or exhibit. One or two lines each, with location.]5253## Exhibits5455[Table by table and figure by figure, only where there is something to say.]5657## Citations and numbers5859[Keys that do not resolve, attributions that could not be verified (say "not verified"),60numbers that disagree, with both locations.]6162## Replication6364[What a replicator is missing. Whether provided code or data were run, inspected or neither.]6566## Questions for the authors67681. [A question whose answer would change the assessment.]6970## Not reviewed7172[Figures available only as images, supplementary files, data, code, anything outside the73reviewer's competence.]74```7576Recommendation and confidential remarks go to the editor, not into this report, unless the77venue asks for them here.7879## Editor decision letter8081```markdown82Dear [corresponding author],8384Thank you for submitting "[title]". [It has been read by n referees | I have read it85closely.] The decision is: [accept | minor revision | major revision | reject].8687[One paragraph: what the paper does and what is valuable in it.]8889[One paragraph: the reasons for the decision, in order of importance.]9091A revision must address the following points. I will check each one against the revised92manuscript:93941. [Essential point, with the referee comment it comes from.]952. [Essential point.]9697The following are recommended but are left to your judgment:9899- [Optional point.]100101Please return, with the revised manuscript, a response letter that quotes each comment,102states what was changed and where (section, page or line), and marks the changes in the103text. [Deadline, format requirements.]104105[For a rejection: the reasons that could not be addressed by a revision, stated plainly,106and what a different paper built on this work would need.]107108Sincerely,109[editor]110```111112## Replication checklist113114Mark each line: yes / partly / no / not applicable, with a location.115116```markdown117### Data118- [ ] Each data source is named, with version, vintage or access date119- [ ] Access route is stated (public archive with identifier, application, purchase, restricted)120- [ ] Sample construction is listed step by step, with the count remaining after each filter121- [ ] The final sample size matches the N reported in the tables122- [ ] Every variable used is defined (construction, unit, transformation)123- [ ] Treatment of missing values and outliers is stated124125### Method126- [ ] The estimating equation or algorithm is written out127- [ ] Standard errors: type and clustering level are stated128- [ ] All tuning choices are reported (bandwidths, lags, priors, hyperparameters) and how they were chosen129- [ ] Every stochastic step has a stated seed130- [ ] Analyses that were run but not reported are acknowledged131132### Code and environment133- [ ] Code is available, with a persistent location134- [ ] Software and package versions are listed135- [ ] There is a map from each table and figure to the script that produces it136- [ ] Run time and hardware are given when they are substantial137- [ ] A licence or terms of use are stated138139### Verification done in this review140- [ ] Code inspected (yes / no)141- [ ] Code run (yes / no; which exhibits were reproduced, to what precision)142- [ ] Discrepancies found: [list with locations]143```144145## Finding ledger146147One row per finding, across all roles, kept through verification.148149```markdown150| ID | Role | Type | Severity | Where | Quote | Problem | Status | Reason for status |151|---|---|---|---|---|---|---|---|---|152| A-01 | audit | wrong | minor | paper.tex:27 | "412 of 1,250 respondents (38.0%)" | 412/1250 is 33.0% | confirmed | recomputed |153| R-01 | referee | not shown | major | Section 5 | "[exact words]" | [problem] | not shown | searched sections 5 to 7 and the appendix |154```155156The rows above show the format only. Replace them with findings from the manuscript under157review.158159## Response-letter check (revision)160161```markdown162| # | Comment (previous report) | Authors' response | Change found in new version | Verdict |163|---|---|---|---|---|164| M1 | [quote] | [summary of the response] | [section, file:line, or "none found"] | resolved / partly / not resolved / resolved differently / new problem |165```166167Then:168169```markdown170## Changes not mentioned in the response letter171[From the version comparison: numbers that changed, sections added or removed, citations172dropped. Each with old and new location.]173174## New findings in the revised version175[From rerunning the audit and rereading changed sections.]176177## Assessment of the revision178[Which essential points are resolved; what remains; recommendation.]179```180