Skip to content

A+ pass 1: resources as data, private progress tracking, CI and licenses - #1

Merged
aqsnyder merged 1 commit into
masterfrom
a-plus/pass-1-foundation
Oct 21, 2026
Merged

aqsnyder merged 1 commit into
masterfrom
a-plus/pass-1-foundation

Conversation

@aqsnyder

Copy link
Copy Markdown
Owner

First of three passes toward A+ across all nine curricula. The plan and the definition of A+ are in reviews/2026-10-a-plus/README.md.

What changes

  • Resources are data. Each section's resources live in <curriculum>/<NN>-…/resources.toml. python tools/build.py regenerates the README resource tables, each curriculum's PROGRESS.md template, the book and course indexes (which now list the sections that use each item), the learning paths and the main page's section index. Ten table layouts became one.
  • Private progress. python tools/progress.py init creates my/ (git-ignored) with your own checklists, notes and projects. status draws progress bars, next says what to do next, log records study time, and sync keeps your ticks after you pull updates.
  • CI. tools/check_repo.py runs on every push and pull request. A monthly workflow checks every external link and opens an issue when any break.
  • Ready for public release: CC BY 4.0 for content, MIT for tools/, and CONTRIBUTING.md. The licensed IPC-2221A copy and Rick Hartley's handout are removed from the tree; the IPC rows now link to IPC's store.
  • One update-curriculum skill for all nine curricula, replacing the four per-curriculum skills; the audit skill uses the new data files.

How it was checked

  • The migration lost nothing: every URL, row, 🔑/⭐/🤖 marker and line of prose in the old resource sections is in the new output (verified by script).
  • python tools/build.py --check and python tools/check_repo.py report 0 problems.
  • progress.py was tested end to end: init, ticking, status, next, log, and sync across a template change (ticks kept, a removed item preserved at the end, your own lines preserved).

Before going public

The two removed PDFs are still in the git history. Before the repo is made public, the history needs rewriting or a fresh repository. That's a separate decision, flagged for the final pass.

Not in this pass

python tools/check_repo.py --strict lists what pass 2 fixes: 342 rows without a link (mostly print books), 132 concept rows with no source, 389 rows without a verified date, and missing authors, years and descriptions.


Generated by Claude Code

- Every section's resources now live in resources.toml. tools/build.py generates
  the README tables, the PROGRESS templates, the book and course indexes, the
  learning paths and the main page's section index. Migration checked for loss:
  every URL, row, marker and line of prose survived.
- tools/progress.py keeps each learner's checklists, notes, projects and time
  log in my/, which git ignores. Ticks survive curriculum updates (stable IDs).
- CI runs tools/check_repo.py on every push and PR; a monthly workflow checks
  external links and opens an issue when any break.
- CC BY 4.0 for content, MIT for tools/. Removed the licensed IPC-2221A copy and
  a third-party handout; links now point to the IPC store.
- One update-curriculum skill for all nine curricula; audit skill updated.
- reviews/2026-10-a-plus/ records what A+ means and the pass plan.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NvphyUpXnsnKocxSvYwdri
@aqsnyder
aqsnyder merged commit 394f39a into master Oct 21, 2026
2 checks passed
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