Skip to content

Book: add the IDE part and missing reference pages; warn about pages left out - #205

Merged
KubaO merged 10 commits into
twinbasic:mainfrom
KubaO:staging
Sep 25, 2026
Merged

KubaO merged 10 commits into
twinbasic:mainfrom
KubaO:staging

Conversation

@KubaO

@KubaO KubaO commented Sep 25, 2026

Copy link
Copy Markdown
Collaborator

Book content

  • New part, The twinBASIC IDE: the overview plus the ten IDE pages with prose of their own.
  • Data Types joins The Core Language.
  • Enumerations and twinBASIC Additions join the Reference Section.
  • The Tutorials index now opens the Tutorials part.
  • _book.yml lists the pages left out on purpose under left_out:, each with a reason.

Builder

  • A link to a page outside the book now opens that page on the website.
  • The build lists such links as OUT OF BOOK instead of BROKEN: 18 targets, down from 32.
  • The PDF step decodes %20 in image paths, so a file name with spaces no longer stops the build.
  • The build warns about a page with no manifest entry, or a manifest entry that no longer matches a page.

New gate

  • check_book_coverage.mjs in test.bat: 12 probes that give each warning a fault to report.
  • Registered in both CI workflows and in the documented gate lists.

Page fixes

  • Menu pages: --- separators no longer turn 35 menu items into headings.
  • New Project: titled "New Project", with Samples and Recent as sections of the page.
  • Compiler Constants: a page title and correct heading levels.
  • Debug Console: Auto Scroll described from the IDE's own code.
  • Toolbar: removed a ⇧ glyph that pulled a system font into the PDF.
  • LLVM Getting Started: removed a stray |.

Also included

  • Round 11 of the use-case evaluation, and fixes for its findings.
  • Project Settings entries filled in from the IDE's own descriptions.
  • The evaluator now runs site-search as a command of its own.

Checks

  • Build: 0 broken links, and no book-coverage warnings.
  • All eleven test.bat and check.bat gates pass.
  • The PDF renders at 2,263 pages.

…- two of round 11's nine chained it after a cd, were refused, and took the search box for missing; the orchestrator's half says how to run a console program at a real prompt and that one process owns the registry tidy
…ode and arguments; two threads, their results and their errors; the tbIDE reference is not automatic, and an add-in the IDE has loaded cannot be rebuilt in place; the 64-bit Long claim as measured; the fresh-clone check made step 1; Project Settings ids on their own headings; the Assert row by its real name
…uns +1.00 completeness and +1.33 actionability with discoverability flat again, a console program that prints nothing and exits 0, an add-in reference the page called automatic, and two evaluators who took one refused search for no search box
…riptions -- every default and Settings key measured on BETA 983, and the two settings the page lacked added
…the build lists it as OUT OF BOOK instead of BROKEN; the PDF step decodes a %20-encoded image path before looking the file up
…erations, twinBASIC Additions and the Tutorials index into the book -- 32 links out of it down to 18; the menu pages' separators no longer turn items into headings, New Project is titled so, and the Toolbar's shift-arrow glyph that pulled Cambria Math into the PDF is gone
…s, and one bookmark in the book; the Debug Console's Auto Scroll described from the IDE's own code -- on at startup, it follows the newest line, turns off when scrolled away and on again when scrolled back, and stays off once clicked off
…s in a part or in a new left_out list with a reason, and the build's summary names a page in neither, a page in both, an entry matching no page and a landing URL naming none; the 37 pages left out today listed
…e warnings -- twelve probes over pages and a manifest built in memory give each of the five findings a fault to report and keep a landing, a foreword and the book page quiet; dropping the chaptered-landing site fails ten of them, ignoring left_out nine
@KubaO
KubaO merged commit c857187 into twinbasic:main Sep 25, 2026
1 check 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