docs(methods): consolidate 5 methods pages to 2 (preserve WASP2-unique contracts)#103
Merged
Jaureguy760 merged 2 commits intodevfrom Apr 19, 2026
Merged
Conversation
…rsion/FDR Rewrite statistical_models.rst as single ~180-line page covering: - Beta-binomial model (unchanged essentials) - LRT with profile-likelihood convention (ρ held at null MLE, df=1) - Dispersion: single vs linear, AIC/BIC choice, ρ bounds (1e-6, 1-1e-6), logit clip (±10) — all WASP2-specific implementation contracts not in any paper - Phased vs unphased (uniform prior over 2^(n-1) configurations) - BH via scipy.stats.false_discovery_control - WASP2 defaults: pseudocount=1, min_count=10 - NaN-propagation warning for manual BH (matches MEMORY.md pitfall) - Output columns Extends mapping_filter.rst canonical-filter contract section with a single paragraph stating the same contract applies at the counting step (only 0x4 unmapped filter). This was previously buried in counting_algorithm.rst:69-75. Preserves four WASP2-unique contracts flagged by both the sophia decision-auditor and co-scientist hypothesis-critic: 1. Canonical filter contract at count step 2. Profile-LRT ρ convention (fix from PR #99) 3. BH-NaN trap warning 4. Default parameter values + ρ/logit bounds Next commit will delete counting_algorithm.rst, dispersion_estimation.rst, fdr_correction.rst and update toctree + cross-refs.
Removed: counting_algorithm.rst, dispersion_estimation.rst, fdr_correction.rst, methods/index.rst. All load-bearing WASP2-unique content (canonical filter contract at count step, profile-LRT ρ convention, BH-NaN trap, default values, ρ/logit bounds) was absorbed into statistical_models.rst and mapping_filter.rst in the previous commit. Updated 2 inbound cross-references: - faq.rst: methods/fdr_correction → methods/statistical_models - tutorials/bulk_workflow.rst: removed duplicate fdr_correction ref, kept single statistical_models ref Top-level index.rst toctree reduced from 6 methods entries to 2. Removed stale "Statistical Methods" landing caption was replaced by the main index.rst's own :caption: Statistical Methods toctree. Side benefit: eliminates the 3 pre-existing Sphinx duplicate-citation warnings (Kumasaka2016, vandeGeijn2015) by removing the duplicate reference definitions in methods/index.rst and the deleted pages. Methods section: 5 pages (883 lines) → 2 pages (~500 lines), a further 43% reduction on top of Tier-B + Tier-D. Agreed reframe from sophia decision-auditor + co-scientist hypothesis-critic review of the "delete all 4" proposal: consolidate instead of erase, to preserve WASP2-specific operational contracts not present in van de Geijn 2015 or in cited textbooks.
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.
Summary
Follow-up to the user's "delete the stats stuff" request. After running a `/co-scientist` hypothesis-critic and a `/sophia-claudette` decision-auditor on the blanket-deletion proposal, both agents independently identified 4 WASP2-unique contracts in the methods pages that are not in any paper or textbook and would be silently lost by full deletion. The agreed reframe: consolidate instead of erase.
What changed
Before (5 methods pages, 883 lines):
After (2 methods pages, ~500 lines):
WASP2-unique contracts preserved
Four load-bearing pieces flagged by the review agents, all preserved:
What got cut
Cross-references updated
Side benefit: fixes pre-existing duplicate-citation warnings
Removing `methods/index.rst` and deleting `dispersion_estimation.rst` eliminates the 3 duplicate-citation warnings (Kumasaka2016, vandeGeijn2015) that shipped with Tier-B.
Test plan
Cumulative reduction (across Tier-B + Tier-D + Tier-E)