Skip to content

docs(statistics): approve the v1 method catalogue - #55

Merged
hyperpolymath merged 3 commits into
mainfrom
docs/approve-method-catalogue
Sep 22, 2026
Merged

hyperpolymath merged 3 commits into
mainfrom
docs/approve-method-catalogue

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

Refs #1 — the approval the issue requires before any method is implemented.

Issue #1 says the bounded catalogue and its supported/unsupported conditions must be
approved before methods exist. This PR is that decision, recorded in the document itself
rather than in a comment that can be missed.

What changed

  • docs/statistics/method-catalogue-v1-draft.md → docs/statistics/method-catalogue-v1.md,
    status APPROVED on 2026-09-22, approved without amendment by the repository
    owner (Jonathan D.A. Jewell, @hyperpolymath).
  • The record states its own scope: approval covers the v1 scope (exact descriptive
    summaries; parametric fits with explicit constraint and convergence reporting;
    nonparametric permutation/bootstrap with stated exchangeability and seeds), the
    per-method publication list as the acceptance gate, and the reading that a
    descriptive summary is the correct default when the information needed for valid
    inference is missing.
  • It also states what approval does not cover: item 4 (exact statistical tests, tracked
    in feat(analysis): Exact statistics layer — Fisher's exact, exact NB, permutation tests #3), any method not listed, and the symbolic work (BLOCKED: assess a symbolic mathematics engine only after deep statistical validation #2), which stays blocked.
  • Approval is of scope and gate, not of method behaviour. Each method still publishes
    its supported/unsupported conditions before implementation, and nothing is implemented
    merely by appearing in the list.
  • The text is the text that was approved; the rename records the decision rather than
    altering it, and the draft name is kept in the record so the approved wording can be
    traced. numeric-contracts.md's single inbound reference is updated.

What this unblocks

Item 1 — descriptive summaries at exact precision (counts and proportions as exact
integers/rationals, no inference claimed) — is first, and depends only on
numeric_policy.jl, which is already on main. Its implementation PR will carry that
method's published conditions, known-answer and independent-reference evidence, and its
negative controls, as the catalogue requires.

Paperwork-only: no code changes, check-format and check-spdx clean.

The repository owner approved the bounded method catalogue on 2026-09-22,
without amendment, satisfying the requirement in #1 that the catalogue and
its supported/unsupported conditions be approved before any method is
implemented. Issue #1's remaining criteria are gated on this document, so
the approval is recorded here rather than in a comment that can be missed.

The record is deliberately explicit about scope. Approval covers the v1
scope (exact descriptive summaries; parametric fits with constraint and
convergence reporting; nonparametric permutation/bootstrap), the
per-method publication list as the acceptance gate, and the reading that a
descriptive summary is the correct default when the information needed for
valid inference is missing. It does NOT cover exact statistical tests
(tracked in #3), any method outside the list, or the symbolic work (#2),
which stays blocked. Approval is of scope and gate, not of method
behaviour: each method still publishes its conditions before implementation,
and nothing is implemented merely by appearing in the list.

The file was method-catalogue-v1-draft.md; the text is the text that was
approved and the rename records the decision rather than altering it. The
draft name is kept in the record so the approved text can be traced, and
numeric-contracts.md's one inbound reference is updated to match.

Refs #1
@coderabbitai

coderabbitai Bot commented Sep 22, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 9 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: a663e23e-2d13-46e0-bfc5-893acdcb9421

📥 Commits

Reviewing files that changed from the base of the PR and between 3fbe926 and 3175675.

📒 Files selected for processing (2)
  • docs/statistics/method-catalogue-v1.md
  • docs/statistics/numeric-contracts.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@hyperpolymath
hyperpolymath enabled auto-merge (squash) September 22, 2026 12:02
@hyperpolymath
hyperpolymath enabled auto-merge (squash) September 22, 2026 12:02
@sonarqubecloud

Copy link
Copy Markdown

@hyperpolymath
hyperpolymath merged commit ab68a6f into main Sep 22, 2026
5 checks passed
@hyperpolymath
hyperpolymath deleted the docs/approve-method-catalogue branch September 22, 2026 12:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant