Skip to content

Three IDE chapters (customising, writing code, running and debugging), an IDE Reference, and 28 IDE defects with reproducers - #230

Merged
KubaO merged 25 commits into
twinbasic:mainfrom
KubaO:staging
Oct 12, 2026
Merged

KubaO merged 25 commits into
twinbasic:mainfrom
KubaO:staging

Conversation

@KubaO

@KubaO KubaO commented Oct 12, 2026

Copy link
Copy Markdown
Collaborator

Restructures the IDE section into task chapters and a reference part, writes the first three chapters with their pictures, and queues the 28 IDE defects found while writing them, each with a reproducer.

  • docs: Customising the IDE (IDE Options, themes, panel layouts, keyboard shortcuts, language), Writing code (editor, IntelliSense, navigating, Find, Diagnostics) and Running and debugging (running, breakpoints, inspecting, Debug Console, Memory) are 17 new pages that absorb 12 old ones, which redirect to them (1131 to 1137 pages). Project Settings moves to /tB/IDE/Project-Settings, and the menus, Toolbar and Status Bar to a new IDE Reference, with the old URLs redirected. Six menu pages (Edit, View, Debug, Run, Window, Tools) are cut to reference entries. Keys are written <kbd>Ctrl</kbd>+<kbd>S</kbd> throughout, and the book's IDE part gains the chapters and a reference group. Modern IDE Features, Debugging, Getting Started with LLVM and the FAQ are corrected and linked to the chapters, and Debug says that Debug.Print writes nothing and Debug.Assert is ignored in a built executable.
  • pictures: 35 new, in both themes with SVGs (18 for Writing code, 16 for Running and debugging, 1 for Memory), and the Edit, View, Debug and Run menus retaken with the editor focused, the program paused and the program running. The ten .af sources in docs/IDE/_Images/ are deleted.
  • shoot_docs: three setups, code-chapter, debugging and memory, with fixture projects in test/shots/.
  • bugs: 28 new entries in BUGS-TO-REPORT.md (BETA 1005), found while trying the chapters' claims in the IDE.
  • notes: WIP.IDE.md (new) holds the plan: the structure, the conventions, where the facts come from and how a chapter is written. Authoring Pages says how the IDE's words, menu paths and keys are written.

The lanes, shoot_docs and the probe need a twinBASIC install, so they stay outside every gate and CI. The probe's command-line cases need none and run in test.bat.

KubaO added 25 commits October 12, 2026 08:14
…reference part, flattened permalinks, book-ready criteria)
…, the menus, Toolbar and Status Bar under a new IDE Reference (/tB/IDE/Reference), old URLs redirected and links updated; the book's IDE part ends in an IDE Reference group; keys written <kbd>Ctrl</kbd>+<kbd>S</kbd> site-wide; the .af sources removed
… to a missing ';', with a probe reproducer (probe_theme_semicolon.mjs) and its Tools-IDE entry
…uts, Keyboard Shortcuts, settings and language); Window and Tools menus cut to reference entries; IDE-Features, LLVM Getting Started and the FAQ corrected and linked
…t override breaks inheritance, an inherits loop freezes the IDE, '|' in a group name), with the customising ide-test lane as their reproducer
…res' labels removed (the pictures are SVG with accessible text)
…als (BETA 1005), with the code-find and code-editor ide-test lanes as their reproducers
…ing, Diagnostics) absorbs the Editor, Find/Replace, Outline, Open Editors, History, Diagnostics and CodeLens pages, with redirects; Edit and View menus as reference entries; Toolbar's Indent/Outdent keys; SHOT markers for the pictures still to take
…ventory sample project, both themes, SVG), the Edit and View menus shown with the editor focused; a tab's tint described as the IDE does it
…he address; a table over a paused program), the formats, columns, editing and auto-refresh; one Memory pane only; its String picture and the memory shot setup
…tint and Shift+F10 at the window's corner (code-editor lane); their callouts on the Memory and Editor pages
… trials (BETA 1005), with the debugging ide-test lane as their reproducer
…ping, Inspecting, Debug Console, Memory moved in) absorbs the Debug Console, Variables, Watches and Call Stack pages and the error walkthrough, with redirects; Debug and Run menus as reference entries; SHOT markers for the pictures still to take
…6 pictures and the Debug and Run menus retaken paused and running); Locals' Me and function-name variable stated as checked
@KubaO
KubaO merged commit d87dd3d into twinbasic:main Oct 12, 2026
1 check passed
@KubaO KubaO mentioned this pull request Oct 12, 2026
24 of 35 tasks
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