Files
reproducibility-reading-rou…/README.md
T

6.4 KiB

Reading for Reproducibility: What to Check Before You Build on a Study

Researchers build on each other's work constantly. A new project borrows a measurement approach from one paper, a dataset from another, a model specification from a third. Each borrowing is a bet that the earlier work was done and reported carefully enough to be reproduced. Many of those bets pay off; some do not, and the cost of discovering a problem halfway through your own project can be months. This guide offers a practical reading routine focused on reproducibility, and explains how an evidence-traceable research workbench such as Yila can help you locate the details that decide whether a study is safe to build on.

Reproducibility versus replicability

It helps to be precise about terms. Reproducibility usually means obtaining the same results from the same data and code. Replicability means obtaining consistent results from new data collected in the same way. Both matter when you build on a study, but they require different checks. For reproducibility, you need access to data, code and a full description of the analysis. For replicability, you need a description of procedures detailed enough that someone else could repeat them.

When reading with an eye to building on a paper, ask both questions: could I rerun this analysis, and could I repeat this study?

Check 1: Is the data available, and in what form?

Look for a data availability statement. Many journals now require one, but statements vary from "data are available in a public repository with a persistent identifier" to "data are available from the authors on reasonable request". The second form is often much less reliable in practice.

If data are available, check the format and documentation. A spreadsheet with cryptic column names is less useful than a dataset with a codebook. Note whether the shared data are the raw data or a processed version, and whether the processing steps are described.

Check 2: Is the code available?

Analysis code is frequently the missing link. Even a clear methods section rarely captures every decision: how outliers were handled, which software version was used, what random seed was set. Look for links to code repositories or supplementary files. If code is unavailable, the methods section has to carry more weight, and your reading of it must be more careful.

Check 3: Are analytical decisions fully described?

Read the analysis subsection with a checklist of decisions that often go unreported:

  • How were variables transformed or categorised?
  • How were outliers identified and treated?
  • How was missing data handled?
  • Which covariates were included, and why?
  • Were models checked for assumptions?
  • Were any analyses run but not reported?

For each decision, note whether the paper states it explicitly, implies it, or omits it. An evidence-traceable assistant is useful for this step. Asking Yila "How did the authors handle missing data, and where is this described?" returns the relevant passages with links, including text in supplementary files you might otherwise overlook. If the assistant finds nothing, that absence is informative.

Check 4: Are procedures described in enough detail to repeat?

For experimental and survey work, replicability depends on procedural detail. Look for the exact wording of key instructions or questions, the timing and order of measurements, the training of staff, and the materials used. Many journals allow extensive supplementary material; check it, because the main text often summarises procedures too briefly to repeat.

Check 5: Do the numbers add up?

Simple internal consistency checks catch a surprising number of problems. Do the sample sizes in tables match those in the text? Do percentages sum sensibly? Are degrees of freedom consistent with reported sample sizes? Do reported means and standard deviations look plausible for the scale used? You do not need to recompute everything, but a few spot checks on key results are worthwhile.

When you find an inconsistency, record its location precisely. A located note such as "Table 2 reports n = 148 for the intervention group; text in Results para 1 reports n = 152" is easy to raise with co-authors or with the original authors.

Check 6: Has the work been corrected, questioned or replicated?

Before building on a study, check for errata, expressions of concern, retractions and published comments. Search for replication attempts and for later papers that reanalysed the data. A study that has been independently replicated is a stronger foundation than one that has not, regardless of how prestigious the original venue was.

Recording what you find

Keep a short reproducibility note for each study you plan to build on. It might include: data availability and format, code availability, a list of unreported decisions, internal consistency issues, and any corrections or replications. Each item should carry a location in the paper or supplement.

These notes pay off in several ways. They help you decide whether to contact authors before starting, they inform the limitations section of your own paper, and they protect you if a reviewer asks why you trusted a particular method or result.

When to contact authors

If a study is central to your project and key details are missing, contact the corresponding author early. Be specific: cite the section and ask the precise question. Specific requests receive better responses than general ones, and a located note makes specificity easy.

Using AI tools responsibly in this routine

AI assistants can greatly speed up the search for specific details in long papers and supplements. They should not be trusted to declare a study reproducible or not. The value of a tool like Yila is that every answer links to its source passage, so you can confirm what the paper actually says before recording it. The judgement about whether the reporting is adequate for your purposes remains yours.

Summary

Before building on a study, check data availability, code availability, analytical decisions, procedural detail, internal consistency and the post-publication record. Record findings with precise locations. This routine takes an hour or two per key paper and can save months of rework. An evidence-traceable research workbench like Yila makes the routine faster by locating the passages that answer each question, while leaving the decision about trust where it belongs.