Skip to content

Navigation Menu

Appearance settings

View all features
- BY COMPANY SIZE
  Enterprises
  Small and medium teams
  Startups
  Nonprofits
- BY USE CASE
  App Modernization
  DevSecOps
  DevOps
  CI/CD
  View all use cases
- BY INDUSTRY
  Healthcare
  Financial services
  Manufacturing
  Government
  View all industries
View all solutions
- EXPLORE BY TOPIC
  AI
  Software Development
  DevOps
  Security
  View all topics
- EXPLORE BY TYPE
  Customer stories
  Events & webinars
  Ebooks & reports
  Business insights
  GitHub Skills
- SUPPORT & SERVICES
  Documentation
  Customer support
  Community forum
  Trust center
  Partners
View all resources
- COMMUNITY
  GitHub SponsorsFund open source developers
- PROGRAMS
  Security Lab
  Maintainer Community
  GitHub Stars
  Archive Program
- REPOSITORIES
  Topics
  Trending
  Collections
- ENTERPRISE SOLUTIONS
  Enterprise platformAI-powered developer platform
- AVAILABLE ADD-ONS
  GitHub Advanced SecurityEnterprise-grade security features
  Copilot for BusinessEnterprise-grade AI features
  Premium SupportEnterprise-grade 24/7 support
Pricing

Appearance settings

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

twinbasic / documentation Public

Notifications You must be signed in to change notification settings
Fork 8
Star 18

Code
Issues 7
Pull requests 1
Discussions
Actions
Wiki
Security and quality
Insights

Additional navigation options

Code
Issues
Pull requests
Discussions
Actions
Wiki
Security and quality
Insights

Second batch of accessibility, content and tooling improvements. - #192

#192

Merged

KubaO merged 177 commits into

twinbasic:maintwinbasic/documentation:mainfrom

KubaO:stagingKubaO/twinBASIC-docs:stagingCopy head branch name to clipboard

Sep 21, 2026

Conversation Commits177 (177)Checks Files changed

Merged

Second batch of accessibility, content and tooling improvements.#192
KubaO merged 177 commits into
twinbasic:mainfrom
KubaO:staging

Commits

Commits on Sep 20, 2026

fonts: self-host Inter, Cascadia Mono and Source Serif 4
KubaO
committed
58f9c6e
diagrams: redraw the Monaco pair as DOT and fix label sizing
KubaO
committed
6170e07
docs: ban "keeping it honest" and rewrite its three uses
KubaO
committed
a9d7638
source: write the cache-key separators as \0 rather than raw NUL bytes
KubaO
committed
340b770
fixture: add the stub fonts the template now preloads
KubaO
committed
be5c9de
docs: bring Pipeline-Stages back in step with the task graph
KubaO
committed
057315c
docs: stop Extending.md teaching the pattern 33624df banned
KubaO
committed
b637305
docs: Building.md -- four gates, not three, and the Graphviz patch exists
KubaO
committed
f385b31
docs: complete the tool catalogue, which covered 7 of 15 scripts
KubaO
committed
d6849c3
docs: name the check subsystem, and fix four stale figures
KubaO
committed
c6ecc5f
WIP: repair the package paths, and four claims that contradict the tree
KubaO
committed
705ccfe
builder: close out the plan docs and repair the README's stale facts
KubaO
committed
2edb0ce
scripts: document the flags the headers omitted, and two stale figures
KubaO
committed
999597b
test: document the fixtures and the invariant that just fired
KubaO
committed
32c8135
README: say how to build the site
KubaO
committed
1d5b8a0
docs: review of the developer documentation over c9f2dfe0..a9d7638
KubaO
committed
a1118ac
discover: strip a leading BOM before parsing frontmatter
KubaO
committed
0f2a438
config: scope the underscore exclude to _Images, not every _* directory
KubaO
committed
07bb679
docs: publish AppGlobalClassObject at its conventional URL
KubaO
committed
3e5575c
nav: require every page to declare its own permalink
KubaO
committed
56fa2d2
docs: record the permalink rule and the AppGlobalClassObject fix
KubaO
committed
c50ffec
docs: record the authoring-only frontmatter keys and what they are for
KubaO
committed
3310b7f
build: refuse to publish file types that are not on the allowlist
KubaO
committed
e4bfc74
serve: print a failed build's cause chain, not just the top message
KubaO
committed
ab8e1ae
docs: cover the build's publish allowlist and three undocumented aborts
KubaO
committed
874896e
docs: correct stale counts and misattributed gates across the developer docs
KubaO
committed
88c7c16
docs: give the two worked example pages the heading levels the guide requires
KubaO
committed
94c3450
docs: point local preview at serve.bat and explain the file:// trap
KubaO
committed
4e66554
docs: link Extending.md and the orphaned test/README.md from the entry-point READMEs
KubaO
committed
15ff547
ci: gate the deploy on the DOT diagram fit check, not just PRs
KubaO
committed
b643013
docs: document check_links_diff's cases, sides and the invocations CI actually runs
KubaO
committed
10e656e
docs: document where project styling lives and the dark-compilation specificity trap
KubaO
committed
ca8b27e
docs: publish the full axe-core upgrade sequence, not just the equivalence gate
KubaO
committed
11b5eba
docs: say what to change when the diagram-fit check fails
KubaO
committed
3f2f852
docs: replace generic and duplicated image alt text with real descriptions
KubaO
committed
026610f
docs: make the scheduler plan's fan-out samples obey the barrier rule they document
KubaO
committed
eb4802b
docs: document what CI runs that a local build does not, and name the target branch
KubaO
committed
66b3c48
docs: state one rule for rewriting a barrier's expected, and flag the dead emit() contract
KubaO
committed
ae86cdb
docs: cover the heading-normalizer disarm trap, index registration, and alt text in the authoring guide
KubaO
committed
b0653cb
docs: point Extending at project styling and the a11y sample, and tabulate the full plugin chain
KubaO
committed
1569e31
docs: give the pull-request and screenshot images real alt text
KubaO
committed
04ab4bf
docs: say precisely which stylesheet the project SCSS compiles into
KubaO
committed
5ab3c9c
docs: note the copied alt text has since been corrected, so readers do not hunt for it
KubaO
committed
d433cae
fix stale case and category counts in check_links_diff comments
KubaO
committed
d74c75f
docs: stop the scheduler plan claiming FIFO ordering makes merges complete first
KubaO
committed
3c46379
move the DOT diagram fit comment above the step it explains
KubaO
committed
2c0c22c
docs: checkChunks is an unindexed append, not an indexed write, and say why
KubaO
committed
c1d4877
docs: name bundle_extra as the third publish-allowlist remedy, and when to prefer it
KubaO
committed
d3c5f96
docs: add the name-the-fault-directly rule and fix the windup phrasings it forbids
KubaO
committed
4ffb67d
docs: fix a detached no_toc IAL, a skipped heading level, and seven double-announcing icon alts
KubaO
committed
7c6a9f3
name bundle_extra as the third remedy in the publish refusal, and demote SOURCE_EXTENSIONS to last
KubaO
committed
955fe8a
docs: reattach four detached no_toc IALs, one of which was leaking a heading into the CEF TOC
KubaO
committed
771c068
docs: apply the directness rule and record the 'bites' substitution
KubaO
committed
025692b
notes: record the Wisdom exception and two prose rules
KubaO
committed
245e989
review: use-case audit of the developer documentation
KubaO
committed
6a79600
eval: retain the documentation use-case harness
KubaO
committed
85185eb
docs: correct the list of highlighted fence languages
KubaO
committed
4d87460
docs: link the use-case harness from the developer entry points
KubaO
committed
2e74de2
review: round-2 use-case audit, recovery and the URL contract
KubaO
committed
f0cc6f6
docs: teach the shipped table-wrapper rule instead of a duplicate plugin
KubaO
committed
342824b
docs: document the root-only scope of the underscore exclusion rule
KubaO
committed
abd5659
docs: correct Builder.md's claim that the vendored theme is pristine
KubaO
committed
c7fb3b8
docs: give the four batch wrappers their real POSIX equivalents
KubaO
committed
0192b64
docs: correct four entry points on check.bat, build.bat and the scheduler plan
KubaO
committed
071c1d6
docs: add book.bat failure triage to the PDF generation page
KubaO
committed
e1c38e7
vendor: correct the just-the-docs README's file counts, step numbering and licence gap
KubaO
committed
d4f7f63
docs: mark BOOKPLAN.md as a Jekyll-era design record and map it to the current pipeline
KubaO
committed
2bb915c
docs: fix gate order, wrapper location, the clone step, and the build.bat && book.bat trap
KubaO
committed
673c68b
docs: name the missing _pdf directory as the cause of a failed write after the process phase
KubaO
committed
75c86b0
docs: describe the page-count guard as the collapse floor it is
KubaO
committed
ac2282c
docs: add AppGlobalClassObject to the /tB/ URL contract
KubaO
committed
c8d6006
docs: document how to rename a heading without breaking its anchor
KubaO
committed
4ed8ac4
docs: replace Building.md's duplicated publish-allowlist remedies with a pointer to Authoring.md
KubaO
committed
7764645
docs: point the publish-allowlist remedies at the build-side enforcement
KubaO
committed
1b8e4db
docs: state what a builder change obliges in the documentation
KubaO
committed
41839fa
docs: write down the bullet dash, capitalisation and parenthesis conventions
KubaO
committed
d4e4458
docs: document render.mjs's renderer overrides and the automatic table wrapper
KubaO
committed
407dfe4
docs: add a tables section covering the wrapper, pipe escaping and the PDF
KubaO
committed
9d04724
docs: document folder-style pages, the permalink trailing slash, and has_toc
KubaO
committed
acc3a2c
docs: point perf/README.md's pdf-lib shim paths at book/ after the Phase 10 cutover
KubaO
committed
3d1c76d
docs: state the VBA/package URL depth asymmetry with both directions worked
KubaO
committed
46efbf0
vendor: add the upstream just-the-docs MIT licence
KubaO
committed
30d2c39
docs: add a changer's path and verification gates to Extending
KubaO
committed
cada12e
docs: replace three figurative phrases in the new Extending sections
KubaO
committed
c2a0023
review: record the corrections the fix pass produced
KubaO
committed
ec0c378
docs: remove the nonexistent [Documentation(...)] attribute from eight sites
KubaO
committed
edd2949
docs: document the Markdown formatting convention for [Description(...)]
KubaO
committed
4a68649
docs: add AppGlobalClassObject to the book, register two fence languages, correct the attribute name
KubaO
committed
dd8e774
docs: ConstantFoldable is module-scoped, not any function
KubaO
committed
ef41570
docs: say why ConstantFoldable stops at module functions
KubaO
committed
e3b8449
docs: describe what each screenshot and diagram actually shows in its alt text
KubaO
committed
ec43bab
docs: describe the two Project Settings screenshots instead of naming their tabs
KubaO
committed
946697f
docs: describe what each IDE screenshot shows instead of repeating its heading
KubaO
committed
b2f8026
notes: the typographer does not reach alt text
KubaO
committed
0541d83
docs: describe what each menu screenshot shows instead of repeating its label
KubaO
committed
e05ff57
docs: describe what the IDE panel screenshots show and drop their duplicate titles
KubaO
committed
14acc20
review: record what remains open
KubaO
committed
10c4e79
fix: book.bat now preserves the PDF renderer's exit code
KubaO
committed
2d1d02e
docs: fix toolchain-overview diagram to match the current check.bat
KubaO
committed
69386e2
docs: add missing vendorAssets, Check-section, and data-dep edges to scheduler-dag
KubaO
committed
449da90
eval: warn against backgrounding a build in a fix pass
KubaO
committed
53ea962
fix: stop VOID_TAGS_RE backtracking exponentially on a slash in a long attribute
KubaO
committed
23ee348
fix: make page order deterministic so search-data.json is reproducible
KubaO
committed
00adc8b
feat: stall watchdog reports the stuck task and its pages, then fails the build
KubaO
committed
6a18f7f
fix: remove the two remaining exponential regexes in the render path
KubaO
committed
b5d9d61
feat: gate on exponentially backtracking regex literals
KubaO
committed
eb93889
refactor: split toolchain tests out of check.bat into test.bat
KubaO
committed
eb891f8
docs: document the stall watchdog, the regex gate, and the check/test split
KubaO
committed
37c8559
docs: correct four menu shortcuts and two typos against their screenshots
KubaO
committed
00ca609
docs: document the compiler executable's own export/import command line
KubaO
committed
5063293
docs: cover the four command-line verbs the usage message omits
KubaO
committed
36b397c
review: record the shortcut fixes, an overstated finding, and that no CLI build exists
KubaO
committed
7faefe7
review: record attributes missing from the reference and the probe-project route
KubaO
committed
7879b00

Commits on Sep 21, 2026

tooling: generate an attribute-placement probe project from Attributes.md
KubaO
committed
78b377a
docs: COMExtensible is not accepted on an interface member; note RunAfterBuild's per-project limit
KubaO
committed
41562f6
docs: DllExport applies to constants, not variables, as its own example showed
KubaO
committed
b430994
review: correct the probed-vs-confirmed counts
KubaO
committed
5badd52
tooling: port convert_em_dash_separators and gen_attribute_probes from Python to JavaScript
KubaO
committed
54d4fed
notes: split font subsetting into WIP.Fonts.md; record the harfbuzzjs CFF2 metrics defect
KubaO
committed
f513645
docs: normalize literal dashes to ASCII source form
KubaO
committed
0768245
docs: drop the inert Jekyll raw tags from SendKeys
KubaO
committed
2135891
docs: reconcile nine IDE pages with what their screenshots actually show
KubaO
committed
e63750f
docs: pin three fragile attribute anchors and close two gaps in the URL contract
KubaO
committed
6b17bd4
docs: mark book page counts as measurement conditions; describe the pipeline diagram
KubaO
committed
2cef18f
builder: drop stripLiquidRawTags, which ate Liquid tags inside code fences
KubaO
committed
895f24c
notes: design build-time counts as named values in prose
KubaO
committed
4523869
builder: guard the book's attribute rewrites against inline code spans
KubaO
committed
888ae91
builder: stop admonition unwrapping from eating code indentation and blank lines
KubaO
committed
4d6e9fc
builder: mask code regions before the kramdown-parity source rewrites
KubaO
committed
dee4adb
tooling: recognise indented, tilde and long fences in the dash normaliser
KubaO
committed
427f77a
test: gate that no pre-render rewrite alters a code region
KubaO
committed
873d154
notes: record the code-region hazard class and its gate
KubaO
committed
b382d41
test: record the html_block blind spot in the code-region gate
KubaO
committed
b897f0d
builder: preserve whitespace inside inline code, which is content not layout
KubaO
committed
1e55c9f
notes: record the inline-code whitespace fix and the trim-boundary trap
KubaO
committed
8ee72cc
review: close the round-2 queue items this session fixed
KubaO
committed
df61726
tooling: make book.bat refuse a stale _site-pdf instead of rendering it
KubaO
committed
02a4ff0
notes: record the book freshness gate and close its queue item
KubaO
committed
e6c634e
docs: document eleven undocumented attributes; ConstantFoldableNumericsOnly is module-only
KubaO
committed
0eb2aab
tooling: probe the five attributes that had no synthesisable argument, and add an exploratory project
KubaO
committed
c7e4243
review: close the IDE-dependent queue; notes: how to get at the package .twin sources
KubaO
committed
a34a36c
tooling: probe the new attribute lines faithfully, and ask six more exploratory questions
KubaO
committed
10cc88a
docs: quote the real CurrentProjectName declaration, which is a Declare and had lost a line
KubaO
committed
a2d84a1
docs: RedirectToStaticImplementation is Interface-only; ComExport takes a Bool; Source stands alone
KubaO
committed
b33342c
docs: give the five placement-less attributes a line; WindowsControl and SpecialCompilerBinding take no Bool
KubaO
committed
3240812
docs: move attribute provenance into HTML comments and round the counts
KubaO
committed
49dd239
tooling, review: use applicability throughout, matching Attributes.md
KubaO
committed
32973db
tooling: compile twinBASIC projects headlessly; settle the last two attribute names
KubaO
committed
fee2885
tooling: let tbbuild find the IDE itself rather than naming an install path
KubaO
committed
b2516f3
review: name the right file for the command-line bug, and a cmd repro for it
KubaO
committed
aad335d
review: reduce the command-line repro to two cmd lines and no project file
KubaO
committed
f8b2c27
review: the command-line repro is one pasted cmd line, not a batch file
KubaO
committed
cc48b88
tooling: add --show/--hide and TBBUILD_SHOW; record what the proxy spike found
KubaO
committed
fd97fe6
review: give the --buildAndExit32 hang a verified five-line repro
KubaO
committed
3e8e23d
review: the queue was not empty; correct four stale entries and surface the open one
KubaO
committed
d9868a9
builder: replace the 836-page floor with a committed baseline the build keeps current
KubaO
committed
b2c7c2a
docs: document LibraryId and Version; fix the fence pairing that silenced six admonitions
KubaO
committed
90a1092
review: close the LibraryId entry; it was two attributes, not one
KubaO
committed
852d286
builder: substitute {{tbdocs:name}} counts in prose, derived on every build
KubaO
committed
ef8b842
review: record the counts mechanism against the stale-figures findings
KubaO
committed
31cc9dd
review, eval: write round 3's cases and what to do next
KubaO
committed
555b975
review, eval: run round 3 -- 8 cases, 13 findings; round 2's fixes measured and landed
KubaO
committed
cb9bfb1
docs, builder: fix round 3's findings; add check_gate_lists to stop the gate lists drifting again
KubaO
committed
bb3ca8a
builder: recognise tilde fences in the admonition stasher; a ~~~ block holding a lone ``` swallowed every admonition after it
KubaO
committed
8f18f62
review: record round 3's outcome -- all thirteen findings closed, plus two the round did not anticipate
KubaO
committed
6f9d0c4
review, eval: run round 4 -- 8 cases, 14 findings; six are round 3's fix pass damaging what it touched
KubaO
committed
e62b571
docs, builder: fix round 4's findings; widen check_gate_lists past the one page it guarded, and publish the stall watchdog
KubaO
committed
98cae35
builder, scripts: check constructed regexes too -- fold new RegExp(...) arguments and report the rest with a reason
KubaO
committed
4f9c9e9
review, eval: run round 5 -- 8 cases, 15 findings; no hazard walked into, and discoverability flat across three re-runs
KubaO
committed
2ac5f15
docs, builder: fix round 5's findings; make script names searchable, give serve-mode and the offline copy a door, derive the enumeration total
KubaO
committed
122539e
review, eval: run round 6 -- 8 cases, 14 findings; add the site-entry protocol and open the reference half
KubaO
committed
e68c4d8
docs: fix round 6's findings; repair three broken samples, give WithEvents a page, reconcile the event mechanism across five pages
KubaO
committed
7ddf84d
docs: revert the form code-behind unwrapping -- a form's .twin file is a Class, confirmed against exported sample sources
KubaO
committed
b3c733a
docs: document the intrinsic Debug object -- Print, TracePrint, Cls and Assert, every syntax claim compiled
KubaO
committed
1c8ea02
docs: drop the print-zone note from the Debug page -- it addressed doc authors, and the parameter description already covers the behaviour
KubaO
committed
f336005
scripts: add tbrun.mjs -- build a probe and capture its Debug Console output; document the measured 14-column print zone
KubaO
committed
da2516e
docs, scripts: guard the Assert example with IsArrayInitialized and state the error-9 hazard on LBound/UBound; fix a stray control char in tbrun's Debug.Cls check
KubaO
committed
4ab817d

Footer

© 2026 GitHub, Inc.

Footer navigation

Terms
Privacy
Security
Status
Community
Docs
Contact

You can’t perform that action at this time.