[viethqb]

Documentation for Wave 1 of the Known-issues fix programme. Every statement was checked against the merged platform PRs #711, #712, #715, #716, #718 and #719 (descriptions and diffs).

Pages changed (27, plus known-issues)

• SQL Lab: explore/sql-lab/permissions.md (KI-159 warning removed; who gets which connection list; the empty and 403 messages), explore/sql-lab/index.md
• Workspace settings: workspace-settings/databases.md (what a non-admin gets; KI-243 limit)
• Dashboards: explore/dashboards/using-filters.md (clearing a default, Reset all filters, URL encoding of a cleared default and an all-options value), filters.md (broken warning about all-options removed, Default value), cards.md (typing in text cards, how date values print), editing.md (limit removed)
• Control plane: control-plane/storage/index.md (Key prefix scoping, root crumb, folders only a platform admin can open, 400 path rules, KI-236), control-plane/secrets.md (System badge, 409, pickers), control-plane/catalogs/create-catalog.md (picker no longer lists system secrets)
• Workflows: workflows/runtime.md (max_concurrent_runs, worker-off notice, KI-237), workflows/flows/inputs-and-outputs.md and workflows/executions/detail.md (SECRET masking, master key, replay, what is not masked), workflows/triggers/index.md (new banner sentence)
• Reference: reference/configuration-keys.md (max_concurrent_runs, unknown-key WARN and the allow-list, catalog.public_url default, master key and SECRET inputs, outdated .env.example warning fixed), reference/cli.md (init output)
• Deploy and operate: configuration.md, local.md, storage-and-catalog.md, authentication.md, kubernetes.md (oidc.devRealm), security-hardening.md, troubleshooting/cannot-sign-in.md, troubleshooting/catalog-storage-errors.md, troubleshooting/workflows-stuck.md
• Get started and FAQ: get-started/quick-start.md (the section that told readers to append storage variables is now "Create the bucket"), faq.md

Known issues

Closed with a Status note: KI-059, KI-060, KI-061, KI-063 (#711); KI-159 (#712); KI-206, KI-129, KI-207 (#715); KI-187, KI-013 (#716); KI-136 (fixed by #704, kept by the test in #718), KI-140, KI-141 (#718); KI-112, KI-146, KI-152 (#719). No S1 row is open now; the intro says so.

Added: KI-236 to KI-246 at the end of the last table. The intro paragraph names their source, and the Not verified note about non-admin use was updated.

Screenshots and what I could not verify

• No screenshot was re-shot. The demo stack at egret.localtest.me:18080 does not run current main for these areas: the Secrets API has no system_managed field, the Secrets page still shows the old subtitle, and the stack has only one secret, with no engine. So admin/cp-secrets is now out of date (no System badge, old subtitle), but I could not capture the new state there.
• The System badge, the worker-off notice (the demo runs the worker), the redacted Engines notice, the hidden-folders line for a non-admin and the SQL Lab empty-list message need setups the demo does not have. They are documented from the PR diffs and not observed.
• The admin view of Storage Browse (the current admin/cp-storage-browse shot) is unchanged by #715.
• The generated REST reference (reference/rest-api/) was not edited. It is stale and should be regenerated from the current openapi.json:
  • databases.md: the list endpoint's 200 response still says "Registered databases in the workspace" with the full row schema. It is now the DatabaseListing oneOf.
  • control-plane-secrets.md: no system_managed field, and the 409 descriptions do not mention system-managed secrets.
  • control-plane-storage.md: no root or hiddenSystemFolders on the listing, and no 400 or 403 for path rules or closed prefixes.
  • workflow.md: worker_enabled is missing on the flow, execution and executions-page schemas.

The build passes for en and vi with DOCUSAURUS_NO_PERSISTENT_CACHE=1 npm run build.

🤖 Generated with Claude Code