FAQ: reproduction aggregation in axis vocabulary, and the replication-chain target rule - #136
Open
LukasWallrich wants to merge 1 commit into
Open
FAQ: reproduction aggregation in axis vocabulary, and the replication-chain target rule#136LukasWallrich wants to merge 1 commit into
LukasWallrich wants to merge 1 commit into
Conversation
…ame a target
Two rules the extraction pipeline codes against but the FAQ did not state.
Aggregation across several analyses was written only in the replication
vocabulary, so "conflicting results" pointed at *mixed* — a value reproductions
do not have. Each axis now aggregates in its own terms.
Replication chains had no entry at all: the rule lived in a project doc as a
fragment ("most likely the closest successor study") whose direction is
ambiguous read alone. Stated with an example instead.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Collaborator
|
Thank you! I suggest we go for option one plus explicitly say that for reproductions, robustness is one of the two axes. And I would not use the term axis but dimensions or facets. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two coding rules that the FLoRA extraction pipeline already applies, but which the FAQ either stated only in replication terms or did not state at all. Both surfaced while writing the FLoRA extractor's outcome prompts (forrtproject/flora-extractor#126), where the FAQ is the authoritative source for coding rules.
1. Reproduction aggregation
"What level is the database?" said that several studies aggregate, and that conflicting results are "considered as mixed". That is the replication vocabulary — reproductions are coded on two independent axes (
outcome_computation,outcome_robustness) and have nomixedvalue at all. A coder following the sentence literally has nowhere to put a reproduction whose analyses disagree.Added: conflicting results aggregate per axis, in that axis's own terms — computational issues on the computational axis, robustness challenges on the robustness axis, and no mixed for reproductions. The wording matches the coded values exactly.
2. The replication-chain target rule
The FAQ had no entry for this. The rule existed only as a fragment in a project doc — "Replication chains: most likely the closest successor study" — whose direction is genuinely ambiguous in isolation: read one way "successor" points forward from the original, when what is meant is the nearest predecessor that the new paper actually re-tests.
Added as its own question, with an example (a 2024 paper re-testing a 2010 finding as measured in a 2018 replication is entered against the 2018 study).
For discussion — the centrality carve-out and robustness checks
@LukasRoeseler — one related point I did not change, because it is a coding-policy call rather than a wording fix.
"What is the outcome based on?" currently says the outcome "refers to whether the central finding that the replication was designed to test could be replicated and may leave out robustness checks and exploratory analyses."
For replications that is clearly right. For reproductions it reads oddly, because robustness is not peripheral there — it is one of the two axes we code: a reproduction whose result collapses under a reasonable alternative specification is coded
robustness challenges, which is exactly a robustness check being included in the outcome. As written, the sentence tells a coder to leave out the thing the robustness axis exists to capture.Options as I see them:
Happy to make whichever edit you prefer; I did not want to guess, since it affects how existing entries were coded.
🤖 Generated with Claude Code