Skip to content

docs: prepare 1.8.0 release#320

Merged
robinskil merged 6 commits into
mainfrom
features/docs-1.8.0
Jun 27, 2026
Merged

docs: prepare 1.8.0 release#320
robinskil merged 6 commits into
mainfrom
features/docs-1.8.0

Conversation

@robinskil

Copy link
Copy Markdown
Collaborator

Prepares the 1.8.0 release: version bump, changelog, release blog, and versioned docs.

Changes

Version

  • Bump 1.7.31.8.0 in beacon-core, beacon-common, beacon-api (beacon_version() reports CARGO_PKG_VERSION).

Changelog & blog

  • Add v1.8.0 — 2026-06-26 entry to docs/docs/changelog/index.md (Added / Changed / Fixed), covering every commit since the v1.7.3 tag.
  • Add release blog docs/docs/changelog/release-1.8.0.md.

Versioned docs

  • Add docs/docs/1.8.0/ (copy of 1.7.3, internal links rewritten).
  • New pages for previously-undocumented flagship features:
    • connect/beacon-typescript-sdk.md (@beacon/client)
    • connect/web-admin-ui.md (bundled /admin UI)

Site config & links

  • docs/.vitepress/config.mts: nav shows 1.8.0 (latest) (1.7.3 kept reachable), new /docs/1.8.0/ sidebar block, changelog release-posts + version list updated.
  • Bump latest-pointing links in README.md, QUICKSTART.md, docs/index.md, docs/public/llms.txt.

Release highlights documented

Lance-backed managed tables (new default engine), Delta Lake, PostgreSQL/MySQL federated external tables, crawlers, the bundled admin web UI, the TypeScript SDK, beacon-cli, the EXPLAIN ANALYZE endpoint, per-format config/OPTIONS, and a batch of integration-test fixes.

Notes

  • Every SQL snippet in the blog was cross-checked against the reference docs (corrected Delta time-travel OPTIONS ('version' …) and crawler ON … WITH (…) syntax).
  • Versioning follows the docs/changelog 1.x line (latest documented was 1.7.3).
  • Docs build not run locally (deps not installed); config validated by parsing.

- Bump version 1.7.3 -> 1.8.0 (beacon-core/common/api)
- Add v1.8.0 changelog entry and release-1.8.0 blog post
- Add versioned docs/docs/1.8.0/ (incl. new TypeScript SDK and Admin Web UI pages)
- Update VitePress nav/sidebar for 1.8.0; bump latest-pointing links (README, QUICKSTART, llms.txt)
@codecov

codecov Bot commented Jun 27, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 74.30%. Comparing base (ddf8414) to head (f012e84).

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main     #320      +/-   ##
==========================================
- Coverage   74.32%   74.30%   -0.02%     
==========================================
  Files         280      280              
  Lines       36298    36298              
==========================================
- Hits        26977    26972       -5     
- Misses       9321     9326       +5     

see 2 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

- New Access Control guide (docs/1.8.0/security/access-control): super-user,
  read-only SQL users/roles, table/path grants & denies (deny-wins), anonymous
  access, OIDC, and the BEACON_AUTH_*/BEACON_OIDC_* config reference
- Wire the Security section into the VitePress sidebar; cross-link from the
  introduction and the configuration reference
- Changelog + release blog: add auth & RBAC, plus the non-SELECT output-format
  error (#318) and super_type Arrow fixes (#319)
Document token validation flow (kid/JWKS lookup, signature, iss/aud/exp),
dotted-path username/roles claims (array or space-delimited), JWKS caching
(TTL, no I/O on the hot path), and Basic-vs-Bearer composite routing. Note that
an invalid token returns 401 and does not fall back to anonymous.
Drop the standalone top-level Security nav section; instead link the Access
Control guide from Data Lakehouse Setup (Enforcement/Roles/OIDC/Config) and from
the SQL Guide DDL group (Users, Roles & Grants: CREATE USER/ROLE, GRANT/DENY).
- Add an inline Quick Start chapter (run -> add data -> explore in admin UI ->
  query over HTTP), mirroring the repo QUICKSTART
- Mention the bundled admin UI at /admin in the Quick Start and Local flows, plus
  a 'secure your instance' note; cross-link the Admin Web UI page
- Add a Quick Start entry to the Getting Started sidebar; expand Next steps
@robinskil robinskil self-assigned this Jun 27, 2026
@robinskil robinskil merged commit 25f5c53 into main Jun 27, 2026
5 checks 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