Skip to content

docs: make the quoted-name examples runnable - #143

Merged
prrao87 merged 1 commit into
mainfrom
docs/runnable-quoted-name-examples
Nov 7, 2026
Merged

prrao87 merged 1 commit into
mainfrom
docs/runnable-quoted-name-examples

Conversation

@prrao87

@prrao87 prrao87 commented Nov 7, 2026

Copy link
Copy Markdown
Member

Why

The quoted-name examples in the Cypher and SQL guides query a Device Type label, but the engine set up earlier on each page has no such label. A reader running either page top to bottom gets a ValueError at that example, and docs/check_snippets.py reports both blocks as failing on main. They came in with quoted identifiers in #121. CI doesn't run the snippet check, which is how they got through.

Separately, #141 moved Spell Check to typos 1.51.1, while the contributor instructions still say to run 1.26.0 locally.

What changed

  • Each quoted-name example now builds a small engine with a Device Type node table keyed by asset id, under names that don't shadow the page's engine, config or graph. The SQL example also shows its result, as the Cypher one does.
  • The local spell-check command in the agent and contributor guides now uses typos 1.51.1, matching CI.

Validation

  • docs/check_snippets.py passes on every page; on main, cypher.md and sql.md each had one failing block.
  • zensical build --strict and typos 1.51.1 pass locally. CI is pending.

🤖 Generated with Claude Code

The quoted-name examples in the Cypher and SQL guides queried a
`Device Type` label that the engine on those pages doesn't have, so
running either page top to bottom failed there. Each example now builds
a small engine with that label.

Also point the local spell check at typos 1.51.1, the version CI runs
since #141.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 7, 2026 •

Copy link
Copy Markdown

Deploying lance-csr with  Cloudflare Pages  Cloudflare Pages

Latest commit: 459ee03
Status: ✅  Deploy successful!
Preview URL: https://bd16d876.lance-csr.pages.dev
Branch Preview URL: https://docs-runnable-quoted-name-ex.lance-csr.pages.dev

View logs

@prrao87
prrao87 marked this pull request as ready for review November 7, 2026 19:45
@prrao87
prrao87 merged commit e436b9d into main Nov 7, 2026
3 checks passed
@prrao87
prrao87 deleted the docs/runnable-quoted-name-examples branch November 7, 2026 19:45
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