docs: catch docs up to the 26.8.0 catalog shell (sidebar, global Queries, Files tab, ES sunset) - #5231
Open
nl0 wants to merge 3 commits into
Open
docs: catch docs up to the 26.8.0 catalog shell (sidebar, global Queries, Files tab, ES sunset)#5231nl0 wants to merge 3 commits into
nl0 wants to merge 3 commits into
Conversation
26.8.0 replaces the top navigation bar with a persistent left sidebar (Volumes, Search, Queries, Bookmarks, Ask Qurator, Admin) and an always-on search bar in the page header. Pages that told users where to click were describing chrome that no longer exists. - Admin: the panel is reached from Admin in the sidebar, not a username dropdown; role switching is the Workspace row at the top of the sidebar, which opens the "Switch workspace" dialog. - FileBrowser: Bookmarks is a top-level sidebar item, not a User account menu entry; the tab is "Files", not "Bucket". - Qurator: "Ask Qurator" is a sidebar item, not a floating bottom-right icon. - URI: the resolver is a chain-link icon button at the right end of the header bar, always present, not a width-dependent "URI" button. - walkthrough: the tour now opens on Volumes and names the current bucket tab set (Overview, Files, Packages, Workflows). Screenshots on these pages still show the old shell and are queued for a separate recapture pass.
Queries moved off the bucket to a workspace-global /queries page, and the
ElasticSearch query console is no longer shown by default — it stays
available only via the `elasticsearch-queries` toggle in Admin > Settings >
Preview features. Docs still described a per-bucket "Queries" tab, an
"Athena tab", and an always-on "ELASTICSEARCH tab".
- Query: the page is /queries, reached from Queries in the sidebar; old
/b/<BUCKET>/queries links redirect there with the bucket carried as a
`?bucket=` scope param. Notes that Queries is Athena-only by default.
- Query, Preferences: `ui.nav.queries: false` no longer hides a tab. It
hides the bucket's entry points into the global page — the tables stat in
the bucket header and the Tabulator tables section on Overview — which is
what the catalog actually reads it for.
- Search: the ES section is now "ElasticSearch query console (legacy)",
framed as retained for existing workflows rather than as a default
feature, with the real admin click-path and the console's actual controls
("Bucket (index scope)", "Select query").
- working-with-elasticsearch: the saved-queries drop-down needs both the
toggle on and a bucket selected as the index scope.
- tabulator, iceberg-tables: "Queries tab"/"Athena tab" -> Queries page.
Also drops a dead `athena-history.png` reference (the file was deleted in
#4217; athena-ui.png already shows the Query executions list) and fixes the
misspelled `bucket-preferences-editor.png` link.
The bucket tabs are Overview, Files, Packages, Workflows as of 26.8.0. These three pages still said "Bucket tab" / "Bucket view". s3-prefix-permissions also pointed its "hide the tab" link at Admin.md#show-and-hide-features-in-the-quilt-catalog, a heading that lives in Preferences.md; retargeted, and "Package tab" -> "Packages tab".
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #5231 +/- ##
==========================================
+ Coverage 54.55% 54.58% +0.03%
==========================================
Files 871 871
Lines 36448 36424 -24
Branches 6438 6429 -9
==========================================
Hits 19883 19883
+ Misses 14807 14788 -19
+ Partials 1758 1753 -5
Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
Comment on lines
+13
to
+16
| The page is workspace-global rather than per-bucket: there is no longer a | ||
| Queries tab on a bucket. Old `/b/<BUCKET>/queries` links redirect here, | ||
| carrying the bucket along as a `?bucket=` scope parameter, which is what | ||
| surfaces that bucket's Tabulator tables as one-click chips. |
Contributor
There was a problem hiding this comment.
Only the bare legacy Queries and Athena routes preserve the bucket as ?bucket=. Workgroup, execution, and ElasticSearch deep links drop that scope, so readers following those links will not see the bucket-specific Tabulator chips promised here.
Suggested change
| The page is workspace-global rather than per-bucket: there is no longer a | |
| Queries tab on a bucket. Old `/b/<BUCKET>/queries` links redirect here, | |
| carrying the bucket along as a `?bucket=` scope parameter, which is what | |
| surfaces that bucket's Tabulator tables as one-click chips. | |
| The page is workspace-global rather than per-bucket: there is no longer a | |
| Queries tab on a bucket. Bare `/b/<BUCKET>/queries` links redirect here, | |
| carrying the bucket along as a `?bucket=` scope parameter, which is what | |
| surfaces that bucket's Tabulator tables as one-click chips. More specific | |
| legacy workgroup, execution, and ElasticSearch links redirect without this | |
| bucket scope. |
Knowledge Base Used: Catalog client features
Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!
Comment on lines
+26
to
+30
| Each volume has four tabs: **Overview**, **Files**, **Packages** and | ||
| **Workflows**. Queries are not among them — the Athena console (and the legacy | ||
| ElasticSearch console, where an administrator has kept it enabled) lives on the | ||
| workspace-global [Queries](../Catalog/Query.md) page, reachable from the | ||
| sidebar. |
Contributor
There was a problem hiding this comment.
Files, Packages, and Workflows are independently controlled by the bucket's ui.nav preferences. Calling this an invariant four-tab layout misleads users whose administrators have hidden one of those tabs.
Suggested change
| Each volume has four tabs: **Overview**, **Files**, **Packages** and | |
| **Workflows**. Queries are not among them — the Athena console (and the legacy | |
| ElasticSearch console, where an administrator has kept it enabled) lives on the | |
| workspace-global [Queries](../Catalog/Query.md) page, reachable from the | |
| sidebar. | |
| By default, each volume has four tabs: **Overview**, **Files**, **Packages** | |
| and **Workflows**; administrators can hide Files, Packages, or Workflows through | |
| bucket preferences. Queries are not among these tabs — the Athena console (and | |
| the legacy ElasticSearch console, where an administrator has kept it enabled) | |
| lives on the workspace-global [Queries](../Catalog/Query.md) page, reachable | |
| from the sidebar. |
Knowledge Base Used: Catalog client features
Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!
This file contains hidden or 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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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.
Docs-only fast-follow for the 26.8.0 catalog shell change. Fixes every P1 from
the 26.8.0 docs sweep plus the mechanical P2s (nav language, tab/page naming).
No
catalog/code touched.Every behavior claim below was re-verified against
origin/mastercatalogsource rather than the audit's paraphrase —
constants/routes.ts,containers/Sidebar/Sidebar.tsx,containers/Sidebar/RoleSwitcher.tsx,containers/Bucket/Nav/Nav.tsx,containers/Queries/{Queries,ElasticSearch}.tsx,containers/App/queryRedirects.jsx,containers/Admin/Settings/Settings.tsx,utils/features.ts,utils/BucketPreferences. Three places where the real UIstrings contradicted the audit are called out under UI strings below.
The ElasticSearch console is sunset, not a preview
docs/Catalog/Search.md's ES section is now "ElasticSearch query console(legacy)", framed as retained for existing workflows — not as a new preview
feature and with no removal timeline invented. The wording throughout is "no
longer enabled by default; an administrator can keep it available by turning on
the ElasticSearch query console toggle under Admin > Settings > Preview
features."
The panel in Admin Settings is genuinely titled "Preview features"
(
containers/Admin/Settings/Settings.tsx:409), and the switch inside it islabelled "ElasticSearch query console" (
utils/features.ts), so the click-pathnames the real UI while the surrounding prose carries the sunset framing. The
front-dooranddata-productsflags in that same panel are real previewsand are deliberately left undocumented here.
What changed, by page
docs/Catalog/Search.mdheader search bar (
/or Cmd/Ctrl+K focuses it) — not "the search button inthe top menu bar".
the sunset framing, the admin click-path, and the console's actual controls:
a Bucket (index scope) selector (single bucket or All readable indexes)
and a Select query drop-down. The old prose described a per-bucket tab
and did not mention the index-scope selector at all.
/queries/esredirects to the Athena console.
docs/Catalog/Query.md/queries./b/<BUCKET>/querieslinks redirect there, carrying the bucket as a?bucket=scope parameter (which is what surfaces that bucket's Tabulatortables as chips). Verified in
containers/App/queryRedirects.jsxandcontainers/Queries/Athena/TabulatorTables.tsx.ui > nav > queriesclaim. The old text said admins can"hide the Queries tab" with it. There is no Queries tab. The flag is still
read, but for two other things: the tables stat in the bucket header
(
containers/Bucket/Header.tsx:126) and the Tabulator tables section on thebucket Overview (
Bucket/Overview/v2/TabulatorTables.tsx:221). The docs nowsay that.
athena-history.pngreference (see Bonus fixes).docs/Catalog/Preferences.mdui.nav.queries: False— same rewrite as above, since this is the referenceadmins actually configure from.
ui.actions.downloadObject,ui.blocks.browser,ui.blocks.gallery.files:"Bucket" tab → "Files" tab. (
ui.nav.filesalready said "Files tab" andgallery.overviewalready said "Overview tab" — the file was internallyinconsistent.)
docs/Catalog/Admin.mdnot "a dropdown menu under username in the navbar".
the current role; clicking it opens the Switch workspace dialog.
(see UI strings — the placement claim was the unsafe part).
docs/Catalog/FileBrowser.mdalready said "Files browser tab").
sidebar. The account menu at the bottom of the sidebar now holds only Sign
Out (
containers/Sidebar/Sidebar.tsx:310).tabs".
docs/Catalog/Qurator.mdQurator in the catalog's left sidebar". The sidebar item's label is
literally "Ask Qurator", not "Qurator".
docs/Catalog/URI.mdbe a 'URI' button" is wrong on both counts. It is now an unconditional
chain-link icon button at the right end of the header bar, tooltipped
"Resolve a Quilt URI" (
components/Layout/ContentBar.tsx:250).docs/Catalog/VisualizationDashboards.mdalready correct).
the audit; same rename class, same page.
docs/advanced-features/tabulator.mdQueries page, Athena-only by default. There has never been an "Athena tab"
at top level; it is a subsection tab of Queries, and with the ES flag off the
tab strip is not rendered at all (
containers/Queries/Queries.tsx:75).docs/advanced-features/iceberg-tables.mdNo inbound links to the old anchor (checked repo-wide).
The Database label is confirmed at
Queries/Athena/Database.tsx:182.docs/advanced-features/s3-prefix-permissions.mddocs/FAQ.mddocs/walkthrough/working-with-the-catalog.mda text filter and a cards/list toggle, and names the sidebar contents and the
header search bar.
and the bucket's README-backed landing page (the Overview tab).
that Queries is not among them.
are.
docs/walkthrough/working-with-elasticsearch.mdelasticsearch-queriestoggle must be on, and the user must select thisbucket in the console's Bucket (index scope) selector. Saved queries load
only for a selected bucket —
queriesConfig.ts:50returns[]for nobucket scope, which the old text did not hint at.
Bonus fixes (not in the audit — found while verifying)
Both are dead links that a link checker would flag:
docs/Catalog/Query.md:24referenced../imgs/athena-history.png, deletedin Athena docs: add screenshots and mention
physical_keyanddefaultWorkgroup#4217 (Nov 2024). Reference removed;athena-ui.pngon the same pagealready shows the "Query executions" list, so the prose was folded into it.
docs/Catalog/Preferences.md:99referenced../imgs/bucket-preferences-editor.png; the file isbuckets-preferences-editor.png. Retargeted.docs/advanced-features/s3-prefix-permissions.md:29linked to../Catalog/Admin.md#show-and-hide-features-in-the-quilt-catalog; thatheading is in
Preferences.md. Retargeted.UI strings that contradicted the audit or the brief
containers/Sidebar/RoleSwitcher.tsx:100(and "Could not switch workspace"on error). The audit proposed only changing the location description;
the dialog title in
switch-role-dialog.pngis itself wrong now. Docs use"Switch workspace".
anywhere.
customNavLinkappears only inutils/CatalogSettings.tsx(thetype) and
containers/Admin/Settings/Settings.tsx(the editor) — there isno read site in the new shell. The audit asked to "verify custom links still
render there"; they do not. Rather than move the claim from the navbar to the
sidebar (which would be a new false statement), the docs now describe the
Settings section's contents without asserting where the link appears. This
looks like a shell-migration regression worth a catalog-side issue.
accurately, sunset framing kept in the prose, per the brief.
Two more catalog-side string mismatches, out of scope for a docs PR but worth
filing:
ui.nav.filesas"BUCKET"and still offersui.nav.queriesas a navigation item called"QUERIES"—catalog/app/components/FileEditor/QuiltConfigEditor/BucketPreferences/BucketPreferences.tsx:197-200.The prose is now right and the editor is wrong. This also blocks one
screenshot recapture (flagged below).
catalog-es-queries-default.pngfootnotes "Quilt uses ElasticSearch 6.7Search API" while the docs say 7.10 throughout.
Screenshot recapture checklist
Not done in this PR — no images were recaptured, renamed, or deleted; all
references still resolve. Recapture needs the new shell live. Every image below
was opened and described from what it actually shows, not inferred from its
filename.
Unless stated otherwise, recapture with
front-doorOFF,data-productsOFF (both are real previews, off by default), so the shell shown is what a
26.8.0 customer sees.
Group A — old shell chrome visible, recapture required (18)
docs/walkthrough/working-with-the-catalog.mdimgs/catalog_homepage.png— Currently: despite the filename, thisis the bucket Overview page for
s3://quilt-example: old dark top bar(bucket selector, Search field, URI/Docs/Jobs/Blog, ADMIN menu), old tab
strip OVERVIEW·BUCKET·PACKAGES·QUERIES, stats header, "Objects by File
Extension" + Downloads charts, README.md block. Should show: the bucket
Overview tab under the new shell (left sidebar visible, header search
bar, tab strip reading Overview·Files·Packages·Workflows). Consider a second
shot of the actual home — the Volumes list with its
h1— since the pagenow describes both.
imgs/catalog_packages_tab.png— Currently: old top bar + old tabstrip, PACKAGES active; package list with Filter/Create Package/Sort by.
Should show: same page, new shell, tab strip reading
Overview·Files·Packages·Workflows.
imgs/catalog_bucket_tab.png— Currently: old top bar + old tabstrip with BUCKET active;
quilt-exampleroot listing. Should show:the same listing with the tab reading Files. (Filename now
misleading; leave as-is or rename in the recapture batch, but update the
reference in the same commit if renamed.)
imgs/catalog_search.png— Currently: old top bar with the query inthe top-bar field, and a per-bucket SEARCH tab in the bucket tab strip.
Both are gone:
/b/:bucket/searchnow redirects to global search(
App.jsx:204) and the query field lives in the header bar. Should show:the global
/searchpage under the new shell, query in the header bar,filter sidebar, no per-bucket SEARCH tab.
imgs/catalog_package_landing_page.png— Currently: old top bar +old tab strip, PACKAGES active; package landing page with CODE/METADATA
panes and a summarized
description.md. Should show: same, new shell.docs/Catalog/Search.mdimgs/catalog-es-queries-default.png— Currently: old top bar; oldtab strip OVERVIEW·BUCKET·PACKAGES·QUERIES·ELASTICSEARCH with
ELASTICSEARCH active; "ElasticSearch queries" panel with "Select query"
(Custom) and a Query body editor; footnote "Quilt uses ElasticSearch 6.7
Search API"; RUN QUERY; Intercom bubble bottom-right. Should show:
/queries/eswithelasticsearch-queriesON — new shell, the Queriesheader card with an Athena | ElasticSearch tab strip (ElasticSearch
active), and crucially the Bucket (index scope) selector, which this shot
does not contain at all. Filename asserts "default", which is now false;
rename in the recapture batch and update the reference.
docs/Catalog/Query.mdimgs/athena-ui.png— Currently: old tab stripOVERVIEW·BUCKET·PACKAGES·QUERIES·ELASTICSEARCH with QUERIES active; "Athena
SQL" panel (Select workgroup, Select a query → "My awesome query", Query body
SHOW TABLES;, Data catalog + Database, RUN QUERY) and a "Query executions"table. Should show:
/queries/athenawithelasticsearch-queriesOFF — new shell, "Queries" header card with no tab strip (a lone tab is
deliberately not rendered,
Queries.tsx:75), the Athena panel, and the Queryexecutions list. The history rows in the current shot query
*_objects-view, replaced by the Icebergpackage_entrytable since 1.70 —prefer fresher example SQL.
imgs/athena-history.png— no longer referenced. File was deleted inAthena docs: add screenshots and mention
physical_keyanddefaultWorkgroup#4217; this PR removes the dangling reference. Nothing to recapture.docs/Catalog/Admin.mdimgs/admin-dropdown.png— Currently: fragment of the old dark topbar (Search field, URI, Docs) with an open white dropdown: "admin –
ReadWriteQuiltBucket" header, Bookmarks, Admin settings (highlighted),
Sign Out. Should show: the left sidebar as an admin, with the Admin
item visible (and ideally selected). Note the new account menu at the bottom
of the sidebar holds only Sign Out — Bookmarks and Admin are now top-level
sidebar items.
imgs/switch-role-menu.png— Currently: the same old dropdown, witha "Switch role – 3 available" row plus a red arrow annotation. Should
show: the sidebar's Workspace box — briefcase icon, current role name,
chevron — which is what opens the switcher now.
imgs/switch-role-dialog.png— Currently: dialog titled "Switchrole" with radios Empty / ReadWriteQuiltBucket (current) / ReadQuiltBucket
and CANCEL/SWITCH. Should show: the same dialog titled "Switch
workspace". The title, not just the surrounding chrome, is stale.
imgs/admin-settings.png— Currently: old top bar ("Go to bucket",Search, Example/URI/Docs, ADMIN); Admin tab strip USERS AND
ROLES·BUCKETS·STATUS·SETTINGS; "Catalog Customization" with four cards:
Navbar link, Theme (logo and color), Default search mode, Enable beta
features. Stale three ways: the first card is now titled "Navigation
link"; a fifth card "Preview features" is missing; and the page now
also carries Packaging Engine Settings, Tabulator Settings and
Support Diagnostics sections below the grid. Should show: full Admin
imgs/admin-buckets.png— Currently: old top bar; Admin tab stripwith only USERS AND ROLES·BUCKETS·SETTINGS — it predates the STATUS tab;
Buckets table with the old circular Q placeholder icons. Should show: new
shell, four-tab Admin strip, and the new tinted-initials discs for buckets
without a custom icon (26.8.0 change). Not flagged by the audit.
imgs/admin-users-roles.png— Currently: no shell chrome (croppedbelow the top bar); four-tab Admin strip; Users / Roles / Policies panels.
The Users row for
_canaryshows an Enabled toggle, an Admin toggle and adelete icon. Stale for a non-shell reason: 26.8.0 removes those controls
for the stack-managed
_canaryaccount, and gives SSO/service accounts areal "Last login". Should show: the Users table with
_canary'scontrols absent. Not flagged by the audit.
docs/Catalog/FileBrowser.md— every crop on this page includes the bucket tabstrip reading BUCKET; all need the strip to read Files.
imgs/catalog-filesbrowser-tab.png— Currently: tab stripOVERVIEW·BUCKET·PACKAGES·QUERIES;
allencellroot listing with CREATEPACKAGE FROM DIRECTORY / DOWNLOAD DIRECTORY / kebab. Should show: the
same with Files active and no QUERIES tab (Workflows may appear
depending on
ui.nav.workflows).imgs/catalog-filesbrowser-bookmarksmenu.png— Currently: old darktop bar with the account dropdown open showing Bookmarks / Admin settings /
Sign Out, over an
allencell / aicslisting. Should show: the sidebarBookmarks item being clicked (badge dot if there are updates).
imgs/catalog-filesbrowser-bookmarkspane.png— Currently: theBookmarks drawer (two s3:// entries, CLEAR BOOKMARKS / CREATE PACKAGE) over
the old top bar and BUCKET tab. Should show: the same drawer over the new
shell.
imgs/catalog-filesbrowser-select.pngandimgs/catalog-filesbrowser-addtobookmarks.png— Currently: tab stripwith BUCKET active;
allencell / aicslisting with two rows checked andthe SELECTED ITEMS / CREATE PACKAGE actions. Should show: same, tab
reading Files.
imgs/catalog-filesbrowser-create-package.png,imgs/catalog-texteditor-edit.png,-create.png,-name.png,-main.png—same family, same viewport;
catalog-texteditor-edit.pngverified to showthe BUCKET tab strip over a
config.yamlfile page. Should show:same flows with the tab reading Files.
imgs/catalog-filesbrowser-glacier-listview.png— Currently: olddark top bar (
s3://quilt-rob-glacier-test, Search, URI/Docs, ROBERT@…) plusthe BUCKET tab strip. Should show: same listing, new shell, Files
tab. Companion crops
-glacier-rehydrate.pngand-glacier-rehydrate-dialog.pngare panel/dialog-sized; check whether theyinclude the strip before recapturing.
docs/Catalog/Qurator.mdimgs/qurator-icon.png— Currently: just the old floatingbottom-right circular chat button (dark disc, sparkle-in-speech-bubble
glyph). That affordance is gone. Should show: the Ask Qurator row in
the left sidebar (assistant icon + label), or be dropped in favour of a shot
of the opened assistant drawer.
docs/Catalog/URI.mdimgs/uri-resolve.png— Currently: old dark top bar with Search /URI / Docs text links, over the "Resolve a Quilt+ URI" page with a filled URI
field and RESOLVE button. Should show: the same page under the new shell,
with the resolver's header-bar entry point being the chain-link icon button
rather than a "URI" text link.
docs/Catalog/Preferences.mdimgs/buckets-preferences-editor.png— BLOCKED on a catalog fix, donot recapture yet. Currently: old top bar + old tab strip
(OVERVIEW·BUCKET·PACKAGES·QUERIES) over the BucketPreferences visual editor;
inside the editor, the "Navigation items" section lists
"BUCKET","PACKAGES","QUERIES"(no"WORKFLOWS"), and Actions says "Downloadbuttons under the 'BUCKET' tab". Should show: the editor with navigation
items matching the real tabs. But those labels are hardcoded stale in
BucketPreferences.tsx:197-200— recapturing now would just re-photographthe wrong strings and contradict this PR's prose. Fix the editor labels
first (see UI strings SparkPackageStore #4), then recapture.
Group B — verified clean, no recapture needed
Panel- and dialog-only crops on touched pages, with no shell chrome:
admin-users-invite.png,default-role.png,admin-role-managed-create.png(verified: bare "Create a role" dialog),
admin-role-managed-attach-policy.png,admin-role-unmanaged-create.png,admin-policy-managed-create.png,admin-policy-managed-bucket-access{,-add,-change}.png,admin-policy-attach-to-role.png,admin-policy-unmanaged-create.png,admin-buckets-add.png(spot-check recommended — 2560x1600 may include the topbar),
package-list-selective-metadata.png,qurator-tools.png,uri-python.png,uri-cli.png,uri-uri.png, thetabulator.mdadmin-panelshots, the
VisualizationDashboards.mdchart/perspective shots, andworking-with-elasticsearch.md's two AWS-console shots.Checklist total: 18 recapture items (1 of them blocked on a catalog fix),
plus 1 already resolved by this PR.
Deliberately deferred
technical-reference.md:404's "Users and Buckets"→"Buckets" naming andapi-reference/cli.md:13's "catalog landing page" phrasing.contradictions today — just gaps: the search "Sort by" control and
mo=URLparam (Support multi-file packages #15); alias IAM roles and their Lake Formation / DataZone implications
(Make the login prompt more helpful #21, Fix building packages in Python2 #28, ArrowPackageStore #31); new Admin Settings subsections for Support Diagnostics and
Preview features as their own reference sections (Update version for PyPI and README #22). These want a writer
with the feature in front of them, not a find-and-replace.
default and correctly absent from
docs/today.Verification
npx --package=markdownlint-cli markdownlint .— clean, matching thelint-docsjob in.github/workflows/js-ci.yml. Baseline was also clean, sono new violations.
docs/resolves (0 broken, down from 2).docs/re-checked; the two anchorsthis PR touches (
Search.md#elasticsearch-query-console-legacy,Preferences.md#show-and-hide-features-in-the-quilt-catalog) resolve, and nopre-existing breakage was introduced.
catalog/.husky/pre-commitrunsnpx lint-staged,whose only pattern is
app/**/*.[jt]s?(x)— a no-op for a docs-only diff,and the husky shim isn't installed in this worktree.
🤖 Generated with Claude Code
Greptile Summary
This docs-only PR updates Catalog documentation for the 26.8.0 shell, including sidebar navigation, global Queries, Files naming, and the legacy ElasticSearch console.
Confidence Score: 4/5
The PR appears safe to merge, with two non-blocking documentation inaccuracies around legacy query redirects and configurable bucket tabs.
The main shell and ElasticSearch documentation matches the implementation, while the accepted issues can mislead users only in legacy deep-link or customized bucket-navigation scenarios.
Files Needing Attention: docs/Catalog/Query.md; docs/walkthrough/working-with-the-catalog.md
Important Files Changed
ui.nav.queries.Reviews (1): Last reviewed commit: "docs: rename the bucket "Bucket" tab to ..." | Re-trigger Greptile
Context used: