Skip to content

docs: guides for the library, algorithms, grammar, StateMate and reference - #126

Merged
thethinkmachine merged 1 commit into
mainfrom
claude/clever-brown-57ki29
Oct 1, 2026
Merged

thethinkmachine merged 1 commit into
mainfrom
claude/clever-brown-57ki29

Conversation

@thethinkmachine

Copy link
Copy Markdown
Owner

Follow-up to #125.

Summary

New guides in docs/, linked from a new Guides section in the README and from the end of each feature section:

  • library.md: search filters (type:, family:, badge:, states:, accepts:/rejects:, a pasted machine code, Match my canvas), entry pages, badges, My Library and offline use, links, submitting, updates vs remixes, running a local copy.
  • algorithms.md: all 35 pages by group, setting M₂ for two-machine operations, the lexer generator.
  • grammar.md: grammar syntax, the 25 tools, CYK vs. the derivation search, worked transforms, conversions to and from the canvas.
  • statemate.md: providers, the build → verify → apply pipeline, Chat/Build/Auto, Standard/Agentic, slash commands, privacy.
  • reference.md: machine pages, the decidability section, language classes.

docs/cli.md fixes and rework

  • Removed a ~180-line block that appeared twice. It was pasted into the middle of the fuzz paragraph in 77fc796; the sentence it cut in half is restored from the comment in cli/commands/fuzz.mjs.
  • Removed a duplicated AppImage row in the install table.
  • Added a by-task index, plus clips of automata play and halts / check-proof.

README

  • Added a Guides section and a "More in …" link per feature.
  • The Algorithms section now uses a clip of the regex → NFA → DFA → minimal DFA pipeline.
  • Corrected the algorithm count from 34 to 35.

Media (docs/media/*.webp)

  • 4 new clips: library, algorithms, reference, automata play.
  • 13 still screenshots.
  • The six clips from docs: rewrite the README, add citation info and animated walkthroughs #125 are re-recorded and re-encoded smaller. Those takes had fallen back to system fonts and untypeset math, because the recording container couldn't reach Google Fonts or jsDelivr; both are now served from local npm copies.
  • All WebP media in docs/media now totals about 12 MB.

Notes

  • The library clip and screenshots were recorded against npm run library:dev serving the automata-library checkout. The status line naming the local emulator is hidden in them.
  • .claude/skills/library/SKILL.md gives the Library view's shortcut as 5. In the code it is 2, and 5 opens the Reference. The guides follow the code; the notes file is unchanged.
  • grammar.png and algorithms.png are no longer referenced by the README but are left in docs/media.

🤖 Generated with Claude Code

https://claude.ai/code/session_017YKJF9uBDjB19vfGA1XE2k


Generated by Claude Code

…reference

Five new guides under docs/, each with a walkthrough clip and screenshots,
linked from a new Guides section in the README and from each feature
section. docs/cli.md loses a 180-line duplicated block (and a duplicated
AppImage row), gets back the fuzz sentence the duplication had cut in
half, and gains two clips (play, halts) and a by-task index.

The README clips are re-recorded with the app's real fonts and typeset
math (they had fallen back to system fonts), and re-encoded smaller.
The algorithm count is corrected to 35.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017YKJF9uBDjB19vfGA1XE2k
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

Copilot AI balanced review requested due to automatic review settings October 1, 2026 10:43

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@thethinkmachine
thethinkmachine merged commit 77ac4c6 into main Oct 1, 2026
5 checks passed
@thethinkmachine
thethinkmachine deleted the claude/clever-brown-57ki29 branch October 1, 2026 10:43
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.

3 participants