Skip to content

feat(standard): switch source of truth to Texinfo — v1.29#8

Merged
UnbreakableMJ merged 1 commit into
mainfrom
switch-source-to-texinfo
Jun 23, 2026
Merged

feat(standard): switch source of truth to Texinfo — v1.29#8
UnbreakableMJ merged 1 commit into
mainfrom
switch-source-to-texinfo

Conversation

@UnbreakableMJ

Copy link
Copy Markdown
Contributor

Summary

  • The_Steelbore_Standard.texi is now the canonical source of truth (replacing .md)
  • Adds Makefile with targets: info, html, md, pdf, docx, clean
  • Adds spacecraft.css — Spacecraft Software HTML theme (Void Navy / Molten Amber / Share Tech Mono / Inconsolata) for texi2any --html output
  • .md is now a generated GFM companion (via DocBook intermediate: texi2any --docbook | pandoc -f docbook -t gfm) — kept tracked for GitHub rendering
  • .html, .info, .pdf, .docx, .odt are all gitignored outputs
  • REUSE.toml updated to cover .texi with override annotation (same reason as .md: §4.3 example SPDX headers in the body must not be parsed)
  • CLAUDE.md updated with new pipeline documentation (local, gitignored)
  • Bumps to v1.29 / 2026-06-23 with changelog entry documenting the switch

Validation

  • makeinfo --no-split The_Steelbore_Standard.texizero errors, zero warnings
  • texi2any --html --no-split --css-include=spacecraft.css ... → HTML built successfully
  • texi2any --docbook | pandoc -f docbook -t gfm → 1336-line .md generated correctly
  • All normative content preserved from v1.28

Test plan

  • makeinfo --no-split The_Steelbore_Standard.texi → zero errors, zero warnings
  • grep "@set VERSION" The_Steelbore_Standard.texi → shows 1.29
  • grep "v1.29" The_Steelbore_Standard.texi → changelog entry present
  • grep "Security by Design" The_Steelbore_Standard.texi → §3.3 heading correct

🤖 Generated with Claude Code

The_Steelbore_Standard.texi is now the canonical source.
The_Steelbore_Standard.md and .html are generated outputs (make md / make html).
.docx/.odt on request only (make docx). Makefile + spacecraft.css added.
.gitignore extended with generated output patterns and TeX aux files.
REUSE.toml updated to cover .texi with override annotation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@UnbreakableMJ UnbreakableMJ merged commit 4af5736 into main Jun 23, 2026
1 check passed
@UnbreakableMJ UnbreakableMJ deleted the switch-source-to-texinfo branch June 23, 2026 13: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