Skip to content

docs: one ranked TODO.md, and a home for the ld370/as370 reference material - #105

Merged
mgrossmann merged 2 commits into
mainfrom
docs/unified-todo
Aug 30, 2026
Merged

docs: one ranked TODO.md, and a home for the ld370/as370 reference material#105
mgrossmann merged 2 commits into
mainfrom
docs/unified-todo

Conversation

@mgrossmann

Copy link
Copy Markdown
Contributor

Replaces two local working notes (TODO-LD370.md, TODO-ASM370.md — never committed, so nothing is lost from history) with one ranked TODO.md plus the reference material they carried.

Why the split

The notes mixed three things: open defects, settled history, and reference material about IFOX00 and the linkage editor. Only the first belongs in a tracker, only the third belongs in docs/, and the second is mostly noise once it is fixed. So:

TODO.md

Modelled on mvslovers/httpd's: the tracker stays the source of truth, and this file holds what it cannot — the order, the reason for it, and what waits on a decision. The ranking rule is the project's own: silent wrong output before silent under-reporting before a loud gap before cosmetics, and inside the top class, having already shipped broken code breaks the tie. That puts #39 (MNOTE severity swallowed — the FREEMAIN it silently deleted in libc370 leaked exactly when storage was short) first.

Two corrections the review turned up

Also here

Documentation only; no code changes.

…al a home

Two working notes on the ld370 and as370 divergences held three kinds of
content at once: open defects, settled history, and reference material about
IFOX00 and the linkage editor. Neither was ever committed, so none of it was
visible to anyone else, and the parts fixed months ago were still described as
open.

Split by owner. Defects that are still live became issues #99-#104, each with a
reproducer and a code citation; the WX-before-ER one is measured on the host,
not derived from the reference. Reference material moved to
docs/ld370-iewl-divergences.md and as370/docs/ifox-option-parity.md, which cite
routines and line numbers rather than reproducing IBM source. What was already
fixed was dropped.

TODO.md is what is left: the order of the open work, the reason for that order,
and which items wait on a decision rather than on code. The ranking rule is the
project's own - silent wrong output before silent under-reporting before a loud
gap before cosmetics, and inside the top class, having already shipped broken
code breaks the tie.

Also added: docs/tool-roadmap.md, the roadmap for tools beyond the four that
build, and docs/entry-point-resolution.md, which issue #10 cites and which
existed only locally until now.
The June version described a toolchain that no longer exists: it listed
multi-track transport, the mbt host backend, the one-command driver and the
built-in C library as open, and all four have landed since. It was also the
last German document in the repository.

Rewritten for what is true now - the whole build runs on the host and only the
install touches MVS - and pointed at TODO.md for the open work rather than
carrying a list of its own, which is how the old one went stale.
@mgrossmann

Copy link
Copy Markdown
Contributor Author

Added a second commit: docs/roadmap-integration.md rewritten in English against the current state. The June version listed multi-track transport, the mbt host backend, the one-command driver and the built-in C library as open — all four landed since — and it was the last German document in the repository. It now points at TODO.md for the open work instead of carrying a list of its own, which is how it went stale in the first place.

@mgrossmann
mgrossmann merged commit c49c1f7 into main Aug 30, 2026
2 checks passed
@mgrossmann
mgrossmann deleted the docs/unified-todo branch August 30, 2026 15:04
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