Skip to content

refactor(data): the description of a problem next to its metadata (T2 of #449) - #465

Merged
ocots merged 1 commit into
mainfrom
refactor/descriptions-next-to-metadata
Nov 20, 2026
Merged

ocots merged 1 commit into
mainfrom
refactor/descriptions-next-to-metadata

Conversation

@ocots

@ocots ocots commented Nov 20, 2026

Copy link
Copy Markdown
Member

Refs #449 (T2). Applied conventions: ct-conventions v0.14.0, ct-agents v0.5.0.

As decided in #449: ext/Descriptions/<problem>.md moves to ext/MetaData/<problem>.md. The hand-written data of a problem, its metadata and its description, are now side by side, with the generated references in ext/MetaData/references/. Adding a problem touches one directory less. The directory keeps its name, and there is no folder per problem.

Changes

  • 22 descriptions moved (git mv, contents unchanged).
  • The readers:
    • the problem pages (docs/problems.jl);
    • the fingerprint of a problem (src/Catalogue/fingerprint.jl);
    • the consistency tests (DATA_FILES: one .jl and one .md per problem in ext/MetaData/, and nothing else);
    • the CI scope tool (tools/ci/scope.py, and its tests).
  • The docs: ext/README.md, test/README.md, docs/src/problems-overview.md, and the layout in AGENTS.md.
  • Package discovery is unchanged: it reads the .jl files of ext/MetaData/ only.

The fingerprint of every problem changes, since the path of its description is part of it. The documentation marks the results as stale until the next crons. #461 already did the same: it changed every metadata file.

Test plan

  • Locally (Julia 1.12): Pkg.test(; test_args=["core"]): 2813 passed, 1 broken (the existing @test_skip).
  • tools/ci: python3 -m unittest discover -s test: 48 tests OK. A change to ext/MetaData/robot.md scopes the problem robot.
  • No reference to Descriptions left (git grep).
  • CI.

🤖 Generated with Claude Code

`ext/Descriptions/<problem>.md` moves to `ext/MetaData/<problem>.md`: the
hand-written data of a problem (metadata, description, and the generated
references) are in one directory. Readers updated: the problem pages,
the fingerprint, the consistency tests, the CI scope tool, and the
READMEs.

Refs #449

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ocots ocots added the run ci github-runner Trigger the CI workflow on GitHub-hosted runners label Nov 20, 2026
@ocots
ocots merged commit 79465cd into main Nov 20, 2026
17 of 18 checks passed
@ocots
ocots deleted the refactor/descriptions-next-to-metadata branch November 20, 2026 07:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

run ci github-runner Trigger the CI workflow on GitHub-hosted runners

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant