Topiary Book: Documentation for the web playground #897
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Also mentioned it's out-of-development status; resolves #875
This was referenced Mar 7, 2025
Merged
nbacquey
approved these changes
Mar 10, 2025
Xophmeister
added a commit
that referenced
this pull request
Mar 11, 2025
Also mentioned it's out-of-development status; resolves #875
Xophmeister
added a commit
that referenced
this pull request
Mar 19, 2025
* Cherry-pick setup from 83b8abd * Update CHANGELOG and PR template * Decant `README` into Topiary Book (#885) * Add GitHub repo link to book config * WIP: Decant README into book * Update usage documentation verifier * WIP: Decant easier parts of reference and TTY playground from README * Preparing ground for capture name documentation * WIP: Plan lift of capture names from README * Reference/Capture names/Basics (first approx.) * Reference/Capture names/{Horizonal spacing,Indentation} (first approx.) * Reference/Capture names/Insertion and deletion (first approx.) * Reference/Capture names/{Vertical spacing,Scopes} (first approx.) * Decant guides into book * Topiary book: Overview of Tree-sitter grammars and queries (#887) * Reorganisation * Moved section on environment variables to Topiary CLI/Runtime dialogue * Not enough to write about RE Tree-sitter grammars, so combined with queries chapter * Tree-sitter crash course * Added note about query syntax support * Topiary Book: Tidy-up Guides (#890) * Add Yann's tutorial to the Guides Resolves #874 * Reworked "Adding a new language" * Reworked "Suggested query development workflow" * Harmonise capitalisation * Add disclaimer to "Adding a new language" * Make the input/expected iteration step clearer * Fixed reference for new numbering * Clarification on what's strictly necessary * Added note RE #query-name! Note: Link is broken in this PR; will be correct with #891 * Topiary Book: Capture names (#891) * Reworked intro * Reworked general advice * Reworked horizontal spacing * Apparently I can't spell horizontal :P * Reworked modification (formerly case) * Reworked insertion and deletion * Reworked indentation * Forgot to remove TODO from horizontal spacing * Applied Nicolas' suggestions * Reworked vertical spacing * Reworked scopes * Fixed link * Applied Yann's and Nicolas' suggestions * Documentation for the web playground (#897) Also mentioned it's out-of-development status; resolves #875 * Topiary Book: Contributing guide (#892) * Set up * Decant CONTRIBUTING.md into contributors' guide * Tidy up contributing guide FWIW... A lot is out-of-date, but I adjusted things as necessary * Note on contributing new language support Resolves #876 * s/represented/supported/ * Simple README * Topiary Book: Editorial sweep (#898) * Easy/cheap changes for consistency * Apparently links in PR descriptions don't work as expected :( * Document C/C++ toolchain dependency * Clean up relics * Topiary Book style guide * Edit wrt style guide * Small tweaks to style guide * Topiary book: Publish book to Topiary website (#906) * Build web playground from 'playground' branch * Build website * Remove website tasks from ci.yml and prepare website.yaml for deployment * Add Topiary Book as a Nix output derivation * Build book in CI * Setup Nix for website build and cache playground assets * Cache Nix build assets rather than the symlink to their directory * Update website landing page w/ link, etc. * Fudge to get caching to work (hopefully) * Another fudge for caching... * Meaningless change to show caching works (hopefully...) * Deploy website * Set book base URL
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Short documentation for the Topiary web playground, including mentioning its current development state (or lack thereof).