Skip to content

Latest commit

 

History

History
323 lines (243 loc) · 18.3 KB

File metadata and controls

323 lines (243 loc) · 18.3 KB

Overview

This roadmap tracks the CΩMPUTER manuscript from rough draft through final release v1.0.0.

Overall Progress: 40% (182/460)

[████████░░░░░░░░░░░░]

Progress

[████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░]
0   10   20   30   40   50   60   70   80   90  100

Pre-Flight Stage Definitions

Stage What It Actually Means
Rough Draft Words exist on page
Content Complete All sections have their intended content, nothing major missing
Tech Review Math, code, diagrams verified correct
Developmental Edit Book-wide consistency: tone, voice, narrative flow, structure
Copy Edit Line-level: grammar, punctuation, style guide
Images All visuals finalized
Layout Typeset, paginated PDF
Proof Error-hunt on formatted output
RC Public release candidate
Final v1.0.0

Pre-Flight Status Matrix

File Rough Draft Content Complete Tech Review Developmental Edit Copy Edit Images Layout Proof RC Final
tex/computer.tex
tex/fig-trinity.tex
tex/macros.tex
tex/titlepage.tex ◽️ ◽️ ◽️ ◽️
tex/00-toc.tex ◽️
tex/01-note-to-the-reader.tex
tex/02-prologue.tex
tex/03-part-1-intro.tex
tex/04-ch-02.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/05-ch-03.tex ◽️ ◽️ ◽️ ◽️ ◽️
tex/06-ch-04.tex ◽️ ◽️ ◽️ ◽️ ◽️
tex/07-part-2-intro.tex
tex/08-ch-05.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/09-ch-06.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/10-ch-07.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/11-ch-08.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/12-part-3-intro.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/13-ch-09.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/14-ch-10.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/15-ch-11.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/16-ch-12.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/17-ch-13.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/18-ch-14.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/19-part-4-intro.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/20-ch-15.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/21-ch-16.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/22-ch-17.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/23-ch-18.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/24-ch-19.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/25-part-5-intro.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/26-ch-20.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/27-ch-21.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/28-ch-22.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/29-ch-23.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/30-ch-24.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/31-part-6-intro.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/32-ch-25.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/33-ch-26.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/34-ch-27.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/35-ch-28.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/36-ch-29.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/37-ch-30.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/38-epilogue.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/39-codex-micro.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/40-codex.tex ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️ ◽️
tex/back-cover.tex ◽️

Appendix

Milestone 1: Rough Draft Complete

Definition: Words exist on the page for every planned section.

Acceptance Criteria

All front matter sections have content (title, legal, dedication, preface)

All chapter files exist with prose (not just outlines)

All part introductions written

Back matter drafted (appendices, glossary, index placeholders, bibliography)

No empty sections marked "TODO: write this"

Document compiles without errors


Milestone 2: Content Complete

Definition: All sections contain their intended content in roughly correct form. Nothing major is missing.

Acceptance Criteria

Each chapter covers all intended topics

All planned examples are present

All proofs/derivations included (even if rough)

Cross-references point to real sections (even if page numbers TBD)

No "[INSERT X HERE]" placeholders remain

Chapter flow makes sense when read sequentially

Scope is locked — no new sections after this point


Milestone 3: Tech Review Complete

Definition: All technical content has been verified for correctness.

Acceptance Criteria

All mathematical notation is consistent throughout All proofs verified step-by-step All code samples tested and working All diagrams accurately represent the concepts Category theory notation follows standard conventions DPO rewriting rules are formally correct WARP graph definitions are internally consistent No hand-wavy claims without justification Bibliography entries verified (authors, years, titles) External reviewer sign-off (if applicable)


Milestone 4: Developmental Edit Complete

Definition: Book-wide consistency achieved. Reads as a unified work.

Acceptance Criteria

Consistent voice throughout (not chapter-by-chapter tone shifts) Terminology used consistently (same term = same meaning everywhere) Notation introduced before use in every case Difficulty progression makes sense (no sudden jumps) Redundancy eliminated (same concept not explained 3 different ways) Transitions between chapters flow naturally Part introductions properly frame their chapters Foreshadowing and callbacks work correctly Reader "mental model" builds progressively Chapter lengths reasonably balanced


Milestone 5: Copy Edit Complete

Definition: Line-level polish. Grammar, punctuation, style guide adherence.

Acceptance Criteria

Grammar checked (no dangling modifiers, subject-verb agreement) Punctuation consistent (Oxford comma decision applied throughout) Hyphenation consistent (e.g., "worldline" vs "world-line" — pick one) Capitalization rules applied (Title Case for headings?) Number style consistent (spell out under 10? Always numerals?) Em-dash vs en-dash vs hyphen used correctly Quotation style consistent (smart quotes, singles vs doubles) Abbreviations introduced on first use No repeated words across line breaks Spelling checked (including technical terms) LaTeX typography correct (\ldots vs ..., proper spacing)


Milestone 6: Images Complete

Definition: All visual assets finalized and production-ready.

Acceptance Criteria

All TikZ diagrams render correctly All SVG files included and sized appropriately Consistent visual style across all figures Color scheme works in both color and grayscale All figures have captions All figures referenced in text Figure numbering correct and sequential Resolution sufficient for print (300 DPI minimum for raster) Alt-text/descriptions for accessibility (if digital) No orphaned images (referenced but missing)


Milestone 7: Layout Complete

Definition: Typeset, paginated, print-ready PDF structure.

Acceptance Criteria

Page size finalized (letter? 6x9? A4?) Margins set for binding type (perfect bound needs gutter) Font choices finalized and embedded Headers/footers consistent Page numbers correct Table of Contents page numbers accurate Chapter starts on recto (right page) if desired No widows (single line at top of page) No orphans (single line at bottom of page) Figures placed near their references No excessive whitespace Code blocks don't break awkwardly across pages Equations properly spaced and aligned Index generated (if applicable)


Milestone 8: Proof Complete

Definition: Error-hunt on the formatted output. RC1 internally reviewed.

Acceptance Criteria

Full read-through on paginated PDF (not source files) All typos caught in this format documented and fixed Page breaks reviewed for awkwardness Spot-check cross-references (do page numbers match?) Spot-check index entries (do they point to right pages?) Print test copy reviewed (if physical release planned) Check on multiple devices/readers (if digital) All flagged issues from proof resolved Change log documented


Milestone 9: Release Candidate

Definition: Public RC. "We believe this is done. Prove us wrong."

Acceptance Criteria

RC announced to beta readers / early access list Feedback collection mechanism in place RC version clearly marked (e.g., "RC1" on cover/title page) Known issues documented (if any) Minimum soak time defined (e.g., 2 weeks for feedback) Feedback triaged: blocking vs nice-to-have vs won't-fix All blocking issues resolved RC2 issued if significant changes made Final sign-off from author


Milestone 10: Final Release (v1.0.0)

Definition: Published. Done. 🎉

Acceptance Criteria

Version number set to 1.0.0 "RC" designation removed from all pages Final PDF generated Distribution channels ready (website, Gumroad, etc.) Announcement prepared ISBN registered (if applicable) Copyright registered (if applicable) Archive copy stored (Git tag, backup)


Pre-Flight Checklist: Final Release

The moment before you push the button. Go through this list one final time.

Legal & Metadata

Copyright page has correct year Author name spelled correctly (laugh, but check) ISBN correct (if applicable) Edition number correct ("First Edition") License terms clearly stated

Content Integrity

Table of Contents matches actual content All cross-references resolve No "TODO" or "FIXME" in text No placeholder text anywhere Bibliography complete

Visual Check

Cover image correct and high-res No broken images All figures render PDF opens without errors in multiple readers

Technical

File size reasonable PDF/A compliant (if archival) Fonts embedded Hyperlinks work (if digital) Bookmarks/outline present in PDF

Distribution

Filename follows convention (e.g., COMPUTER-v1.0.0.pdf) Upload to distribution platform tested Download and verify the uploaded file Announcement drafted and reviewed Social media posts queued (if applicable)

Emotional Readiness

You've accepted it will never be perfect You've accepted someone will find a typo on page 3 You're ready to move on to the next thing