Skip to content

Docs onboarding - #3

Merged
JetSquirrel merged 5 commits into
mainfrom
docs-onboarding
Sep 24, 2026
Merged

JetSquirrel merged 5 commits into
mainfrom
docs-onboarding

Conversation

@JetSquirrel

Copy link
Copy Markdown
Owner

No description provided.

JetSquirrel and others added 5 commits September 24, 2026 00:50
…dable

A dashboards page, in both languages, is the one place the .dash format is
described: a complete example (also downloadable, over the tutorial's sample
data), how to open and edit a dashboard, every block and attribute, plot
types, values and heredocs, the read-only SQL rules, how relative paths
resolve, the plotting limits, validation, and the messages people actually
hit. The CLI and app guides point to it instead of carrying the format.

For search engines and link previews:
- a sitemap with per-page lastmod (the Pages workflow now checks out full
  history so the dates are real)
- a description for every page, and search-result titles for the two homes
- canonical URLs, en / zh-CN / x-default alternates, Open Graph and Twitter
  cards with a preview image
- SoftwareApplication structured data on the home pages

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
DESCRIBE only plans a statement: a cast the build cannot perform, or a value
deep in the data that will not convert, surfaces only once rows are read. A
check that passed such a dashboard handed over one the GUI could not draw.

Against a database the check now describes each query for the column check
and then runs it through the view's own `run_of` — read-only SQL on a
read-only connection, the same row budget — and reports every failing query
at once (exit 1, kind `sql`), not only the first. The static check without a
database is unchanged. Help, CLI guide and skill say so.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Every plot keeps its default height and the tab scrolls, rather than a dozen
plots crushed into one screen with the rest out of reach. Dragging a divider
still trades height between neighbours, and a tab taller than the stack is
filled as before.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The website — a product page at ducklocal.app and the guides at
docs.ducklocal.app, both on Cloudflare Pages — now lives in its own
repository, JetSquirrel/ducklocal-site, which carries docs/ with its history.
This repository drops docs/ and points the READMEs and the two source
comments that cited a guide at the new addresses.

jetsquirrel.github.io/DuckLocal/ is linked from READMEs, issues and search
results, so its GitHub Pages workflow now publishes redirects instead of the
site: scripts/pages-redirects.sh writes a page for every old address — the
English pages, their zh/ twins and the older .zh-CN.html ones — with a
canonical link and a meta refresh, and a 404.html that sends any other path
to the same path on the docs site.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The docs are served under /docs/ on the product page's domain rather than
at docs.ducklocal.app. The READMEs, the two source comments and the
redirects from the old GitHub Pages address follow.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@JetSquirrel
JetSquirrel merged commit 28f3ee7 into main Sep 24, 2026
1 check passed
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