Skip to content

ROADMAP master list is empty but is referenced by surrounding prose #267

Description

@gabrielfrasantos

Severity: low
Domain: docs
Status: VERIFIED — read against a210d34 on 2026-08-10
Suggested labels: documentation

Summary

ROADMAP.md has a ## Master list (by priority) table containing only a header row.
The paragraph immediately after it refers to "Items 48–52", so the list either lost its content or
was never filled in. Readers cannot resolve any item reference.

Split out of issue 018, which now covers only the numeric-policy question.

Evidence

## Master list (by priority)

| #  | Component                                            | Target module         | Difficulty |
|----|------------------------------------------------------|-----------------------|------------|

Items 48–52 are the **evaluation & metrics primitives** — reusable quantities the per-family
unit-test reference [`TESTING.md`](TESTING.md) depends on but which
the library does not yet expose. Detailed below under
[Evaluation & metrics primitives](#evaluation--metrics-primitives).

The table body is empty; the difficulty legend above it and the "Evaluation & metrics primitives"
section below it are both intact, which suggests the rows were removed rather than never written.

Impact

  • The "Items 48–52" reference, and any other numbered reference, is unresolvable.
  • Contributors have no prioritised backlog, which is the file's stated purpose
    ("Prioritised backlog of reusable numerical components").
  • The difficulty legend documents a rating scheme that nothing uses.

Suggested fix

Pick one:

  1. Restore the rows — check git log -- ROADMAP.md for the last revision that had them.
  2. Repopulate from roadmap/PROPOSED_ALGORITHMS.md, which
    contains 33 audit-derived candidates already formatted with Component / Target module /
    Difficulty columns matching this table.
  3. Delete the empty table and rewrite the prose to name items instead of numbering them.

If option 2 is used, note that the proposed numbering will not match the historical "48–52"
references — those need rewriting either way.

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions