Skip to content

py-doc new FILE.md numbers an existing Markdown file; a guide page fo… - #135

Merged
markbac merged 1 commit into
mainfrom
claude/gracious-ride-1x1cpi
Oct 16, 2026
Merged

markbac merged 1 commit into
mainfrom
claude/gracious-ride-1x1cpi

Conversation

@markbac

@markbac markbac commented Oct 16, 2026

Copy link
Copy Markdown
Owner

…r legacy files

py-doc new FILE.md gives an existing Markdown file the next number and writes its legacy build file beside it, naming the file in entries; the Markdown is not changed. The title comes from its front matter, else its first heading, and the author, version, classification and description from its front matter, as defaults the options and the wizard can change. A file whose front matter has a document_number, or that a build file in the register already uses, is refused. The paths it prints are relative to the current folder, so the build command it suggests works as shown.

docs/guide/10_legacy.md describes everything legacy in one place: the build file key by key (read, ignored or unsupported), build --legacy, new and its wizard, numbering an existing file, the register (number format, lists, the first register, --scan, --start, working on branches), the directives legacy documents use, and migrate. The reference page points to it, and it is in the user guide, the guide's index and the README. The reference no longer says the version in the file name and the status templates have no equivalent: migrate carries both over.

Claude-Session: https://claude.ai/code/session_01Ket2UPXgz46XKSUqpuPixk

…r legacy files

py-doc new FILE.md gives an existing Markdown file the next number and
writes its legacy build file beside it, naming the file in entries; the
Markdown is not changed. The title comes from its front matter, else its
first heading, and the author, version, classification and description
from its front matter, as defaults the options and the wizard can change.
A file whose front matter has a document_number, or that a build file in
the register already uses, is refused. The paths it prints are relative to
the current folder, so the build command it suggests works as shown.

docs/guide/10_legacy.md describes everything legacy in one place: the
build file key by key (read, ignored or unsupported), build --legacy, new
and its wizard, numbering an existing file, the register (number format,
lists, the first register, --scan, --start, working on branches), the
directives legacy documents use, and migrate. The reference page points
to it, and it is in the user guide, the guide's index and the README.
The reference no longer says the version in the file name and the status
templates have no equivalent: migrate carries both over.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ket2UPXgz46XKSUqpuPixk
@markbac
markbac merged commit d27274f into main Oct 16, 2026
7 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.

2 participants