diff --git a/platform/control-plane/access-control/users.md b/platform/control-plane/access-control/users.md index 83fb49c..efeaec6 100644 --- a/platform/control-plane/access-control/users.md +++ b/platform/control-plane/access-control/users.md @@ -53,7 +53,7 @@ Prefer SSO for people. A local account has its own password and does not follow Select a user to open their page. The header shows the avatar, name, status, provider and email, with **Disable** (or **Enable**) and **Delete**. A local account also has **Reset password**: *Set a new password for this local account. Their existing sessions are signed out immediately.* -![The page of Farid Haddad: details, two platform roles and one group](/img/platform/admin/cp-user-detail.png) +![The page of Farid Haddad: details, his directly granted platform role and one group](/img/platform/admin/cp-user-detail.png) ### Details diff --git a/platform/data-api/endpoints/publishing.md b/platform/data-api/endpoints/publishing.md index 24c4447..5e6c698 100644 --- a/platform/data-api/endpoints/publishing.md +++ b/platform/data-api/endpoints/publishing.md @@ -6,7 +6,7 @@ sidebar_position: 8 Consumers never see your draft. They see a **version**: a frozen snapshot of the endpoint's contract (SQL, parameters, response settings, cache, limits and rate limit) taken when you press **Publish**. You can edit the draft as much as you like without affecting anyone, and go back to an earlier version in one click. -![The Versions tab of Orders by status: v2 Live with a 1 breaking change badge over its note, and v1 with Roll back](/img/platform/data-api/endpoint-versions.png) +![The Versions tab of Orders by status: v2 Live with a 1 breaking change badge beside its note, and v1 with Roll back](/img/platform/data-api/endpoint-versions.png) ## Publish an endpoint diff --git a/platform/workspace-settings/roles-and-permissions.md b/platform/workspace-settings/roles-and-permissions.md index 51f809f..e3097df 100644 --- a/platform/workspace-settings/roles-and-permissions.md +++ b/platform/workspace-settings/roles-and-permissions.md @@ -6,9 +6,9 @@ sidebar_position: 3 **Workspace settings → Access → Roles & permissions** shows what each workspace role can do in this workspace. It is a read-only view: roles are defined once for the whole platform and apply to every workspace. -![The workspace Roles and permissions page with three built-in roles and two custom roles](/img/platform/admin/ws-roles.png) +![The workspace Roles and permissions page with the three built-in roles and the custom roles, each with its permission count](/img/platform/admin/ws-roles.png) -*Roles are defined platform-wide in Control Plane → Access control and apply to every workspace. This is a read-only view.* +*Roles are defined platform-wide in Control Plane → Access control and apply to every workspace. This is a read-only view. The Control Plane also lists `data_api_invoker`: it is granted on one Data API endpoint, never as a workspace role, so it is not shown here.* ## The summary diff --git a/scripts/screenshots.mjs b/scripts/screenshots.mjs index 17a6cb6..5315c0f 100644 --- a/scripts/screenshots.mjs +++ b/scripts/screenshots.mjs @@ -55,6 +55,8 @@ if (STATE) await ctx.storageState({path: STATE}); for (const s of shots) { if (s.id === 'login' || !wanted(s.id)) continue; + // A shot that sets a taller viewport in prepare() must not leak it into the next one. + await page.setViewportSize({width: 1440, height: 900}); await page.goto(`${BASE}${s.path}`, {waitUntil: 'networkidle'}); if (s.prepare) await s.prepare(page); await page.waitForTimeout(s.settle ?? 800); diff --git a/scripts/shots/alerts.mjs b/scripts/shots/alerts.mjs index 2070718..6ebec12 100644 --- a/scripts/shots/alerts.mjs +++ b/scripts/shots/alerts.mjs @@ -2,7 +2,8 @@ // Run scripts/seed-dashboards.mjs and then `scripts/seed-alerts.mjs --run` first, so the lists, run logs // and the Mailpit inbox have content. Mail shots read Mailpit (MAILPIT, default http://localhost:8025): // the demo stack delivers every mail there. -const ws = '/explore/default'; +// DOCS_WS picks the workspace the Explore objects live in (default: `default`). +const ws = `/explore/${process.env.DOCS_WS ?? 'default'}`; // The alert whose run log alerts/run-log shows (RUN_LOG_ALERT overrides it). const RUN_LOG_ALERT = process.env.RUN_LOG_ALERT ?? 'Pending orders above 100'; const MAILPIT = process.env.MAILPIT ?? 'http://localhost:8025'; diff --git a/scripts/shots/charts.mjs b/scripts/shots/charts.mjs index 2228b90..e5453d1 100644 --- a/scripts/shots/charts.mjs +++ b/scripts/shots/charts.mjs @@ -1,7 +1,8 @@ // Screenshots for platform/explore/charts/*. Charts and datasets come from scripts/seed-charts-deep.mjs; // folders, bookmarks and the trashed chart from scripts/seed-sql-charts-lists.mjs. // Every prepare() starts on the Charts list, finds the chart by its exact name, and opens the wanted tab. -const ws = '/explore/default'; +// DOCS_WS picks the workspace the Explore objects live in (default: `default`). +const ws = `/explore/${process.env.DOCS_WS ?? 'default'}`; const PANEL = 'div[class*="w-[400px]"]'; const open = (name, tab, then) => async (page) => { diff --git a/scripts/shots/dashboards.mjs b/scripts/shots/dashboards.mjs index 929c7c2..0750e07 100644 --- a/scripts/shots/dashboards.mjs +++ b/scripts/shots/dashboards.mjs @@ -1,6 +1,7 @@ // Screenshots for the Dashboards docs (platform/explore/dashboards/*). Run scripts/seed-dashboards.mjs first. // Every prepare() starts from the Dashboards list, opens a dashboard by name and drives the UI from there. -const ws = '/explore/default'; +// DOCS_WS picks the workspace the Explore objects live in (default: `default`). +const ws = `/explore/${process.env.DOCS_WS ?? 'default'}`; const link = (page, name) => page.getByRole('link', {name, exact: true}).first(); const open = (name) => async (page) => { // The auto-apply switch is a per-dashboard browser preference; start every shot from the default (on). diff --git a/scripts/shots/data-api.mjs b/scripts/shots/data-api.mjs index 6063c70..283141e 100644 --- a/scripts/shots/data-api.mjs +++ b/scripts/shots/data-api.mjs @@ -1,6 +1,7 @@ // Screenshots for the Data API and Alerts & reports pages (Apps: scripts/shots/apps.mjs). // Data API objects are created by scripts/seed-data-api.mjs (TRAFFIC=1 also fills Activity). -const ws = '/explore/default'; +// DOCS_WS picks the workspace the Explore objects live in (default: `default`). +const ws = `/explore/${process.env.DOCS_WS ?? 'default'}`; const A = 'data-api'; const tall = (h) => (page) => page.setViewportSize({width: 1440, height: h}); diff --git a/scripts/shots/sql-datasets.mjs b/scripts/shots/sql-datasets.mjs index adc19ea..9391c67 100644 --- a/scripts/shots/sql-datasets.mjs +++ b/scripts/shots/sql-datasets.mjs @@ -1,7 +1,8 @@ // Screenshots for the SQL Lab and Datasets & metrics pages (area: sql-datasets). // Objects used here are created by scripts/seed-sql-datasets.mjs (datasets "Orders with customers" and // "Line items", saved queries, snippets, charts, query history). -const ws = '/explore/default'; +// DOCS_WS picks the workspace the Explore objects live in (default: `default`). +const ws = `/explore/${process.env.DOCS_WS ?? 'default'}`; // ---------------------------------------------------------------- SQL Lab helpers // Replace the editor text. diff --git a/static/img/platform/admin/cp-audit-log.png b/static/img/platform/admin/cp-audit-log.png index bb87822..414eb7a 100644 Binary files a/static/img/platform/admin/cp-audit-log.png and b/static/img/platform/admin/cp-audit-log.png differ diff --git a/static/img/platform/admin/cp-engine-catalogs.png b/static/img/platform/admin/cp-engine-catalogs.png index 1328a9d..aeadd02 100644 Binary files a/static/img/platform/admin/cp-engine-catalogs.png and b/static/img/platform/admin/cp-engine-catalogs.png differ diff --git a/static/img/platform/admin/cp-engine-workspaces.png b/static/img/platform/admin/cp-engine-workspaces.png index bfee709..5fed1bf 100644 Binary files a/static/img/platform/admin/cp-engine-workspaces.png and b/static/img/platform/admin/cp-engine-workspaces.png differ diff --git a/static/img/platform/admin/cp-user-detail.png b/static/img/platform/admin/cp-user-detail.png index 469b5a0..1eebec3 100644 Binary files a/static/img/platform/admin/cp-user-detail.png and b/static/img/platform/admin/cp-user-detail.png differ diff --git a/static/img/platform/admin/cp-users-bulk.png b/static/img/platform/admin/cp-users-bulk.png index ec38f1f..8ef1262 100644 Binary files a/static/img/platform/admin/cp-users-bulk.png and b/static/img/platform/admin/cp-users-bulk.png differ diff --git a/static/img/platform/admin/ws-add-member.png b/static/img/platform/admin/ws-add-member.png index 15af4c7..7f3a0d9 100644 Binary files a/static/img/platform/admin/ws-add-member.png and b/static/img/platform/admin/ws-add-member.png differ diff --git a/static/img/platform/admin/ws-members.png b/static/img/platform/admin/ws-members.png index c1e4dd3..e9f70fa 100644 Binary files a/static/img/platform/admin/ws-members.png and b/static/img/platform/admin/ws-members.png differ diff --git a/static/img/platform/admin/ws-roles-expanded.png b/static/img/platform/admin/ws-roles-expanded.png index 6820b38..26295c1 100644 Binary files a/static/img/platform/admin/ws-roles-expanded.png and b/static/img/platform/admin/ws-roles-expanded.png differ diff --git a/static/img/platform/admin/ws-roles.png b/static/img/platform/admin/ws-roles.png index fc78830..d50731d 100644 Binary files a/static/img/platform/admin/ws-roles.png and b/static/img/platform/admin/ws-roles.png differ diff --git a/static/img/platform/alerts/alerts-list.png b/static/img/platform/alerts/alerts-list.png index 8072cf9..1258b6f 100644 Binary files a/static/img/platform/alerts/alerts-list.png and b/static/img/platform/alerts/alerts-list.png differ diff --git a/static/img/platform/alerts/detail.png b/static/img/platform/alerts/detail.png index b4bf42e..078c0ba 100644 Binary files a/static/img/platform/alerts/detail.png and b/static/img/platform/alerts/detail.png differ diff --git a/static/img/platform/charts/editor-export.png b/static/img/platform/charts/editor-export.png index b6af0d7..bf45182 100644 Binary files a/static/img/platform/charts/editor-export.png and b/static/img/platform/charts/editor-export.png differ diff --git a/static/img/platform/charts/gauge-display.png b/static/img/platform/charts/gauge-display.png index cce17ef..2b620d9 100644 Binary files a/static/img/platform/charts/gauge-display.png and b/static/img/platform/charts/gauge-display.png differ diff --git a/static/img/platform/charts/progress-data.png b/static/img/platform/charts/progress-data.png index c683e45..9c926f1 100644 Binary files a/static/img/platform/charts/progress-data.png and b/static/img/platform/charts/progress-data.png differ diff --git a/static/img/platform/charts/row-data.png b/static/img/platform/charts/row-data.png index 37caf79..b40d966 100644 Binary files a/static/img/platform/charts/row-data.png and b/static/img/platform/charts/row-data.png differ diff --git a/static/img/platform/charts/scalar-display.png b/static/img/platform/charts/scalar-display.png index 6c6e536..8c20967 100644 Binary files a/static/img/platform/charts/scalar-display.png and b/static/img/platform/charts/scalar-display.png differ diff --git a/static/img/platform/charts/table-data.png b/static/img/platform/charts/table-data.png index 5ce4456..c20481c 100644 Binary files a/static/img/platform/charts/table-data.png and b/static/img/platform/charts/table-data.png differ diff --git a/static/img/platform/control-plane-access-overview.png b/static/img/platform/control-plane-access-overview.png index e43e0c0..6f8d147 100644 Binary files a/static/img/platform/control-plane-access-overview.png and b/static/img/platform/control-plane-access-overview.png differ diff --git a/static/img/platform/dashboards/card-export.png b/static/img/platform/dashboards/card-export.png index 68a3eda..6a74f34 100644 Binary files a/static/img/platform/dashboards/card-export.png and b/static/img/platform/dashboards/card-export.png differ diff --git a/static/img/platform/data-api/endpoint-access.png b/static/img/platform/data-api/endpoint-access.png index d9551df..2c5120a 100644 Binary files a/static/img/platform/data-api/endpoint-access.png and b/static/img/platform/data-api/endpoint-access.png differ diff --git a/static/img/platform/data-api/endpoint-params.png b/static/img/platform/data-api/endpoint-params.png index 20dce69..00b2838 100644 Binary files a/static/img/platform/data-api/endpoint-params.png and b/static/img/platform/data-api/endpoint-params.png differ diff --git a/static/img/platform/data-api/endpoint-versions.png b/static/img/platform/data-api/endpoint-versions.png index 9add490..e699101 100644 Binary files a/static/img/platform/data-api/endpoint-versions.png and b/static/img/platform/data-api/endpoint-versions.png differ diff --git a/static/img/platform/sql-datasets/datasets-row-menu.png b/static/img/platform/sql-datasets/datasets-row-menu.png index fbaf0c3..c522653 100644 Binary files a/static/img/platform/sql-datasets/datasets-row-menu.png and b/static/img/platform/sql-datasets/datasets-row-menu.png differ diff --git a/static/img/platform/sql-datasets/ds-preview.png b/static/img/platform/sql-datasets/ds-preview.png index ef4b891..38a4aa1 100644 Binary files a/static/img/platform/sql-datasets/ds-preview.png and b/static/img/platform/sql-datasets/ds-preview.png differ diff --git a/static/img/platform/sql-datasets/ds-usage.png b/static/img/platform/sql-datasets/ds-usage.png index 551b946..69cad64 100644 Binary files a/static/img/platform/sql-datasets/ds-usage.png and b/static/img/platform/sql-datasets/ds-usage.png differ