Skip to content

docs: fix two stale UI labels found by walking the platform (HTTP rows, Kai Agent button) - #1079

Draft
Iamfle4ka wants to merge 2 commits into
mainfrom
docs/stale-ui-labels
Draft

docs: fix two stale UI labels found by walking the platform (HTTP rows, Kai Agent button)#1079
Iamfle4ka wants to merge 2 commits into
mainfrom
docs/stale-ui-labels

Conversation

@Iamfle4ka

Copy link
Copy Markdown
Collaborator

Four places where our docs describe an interface that has moved on. All four were found by actually walking the platform for the Getting Started rework (#1071) and verified live in a project on 2026-08-04 — none is inferred.

Kept out of #1071 deliberately: these belong to their own sections.

flows/

Scheduling is no longer a Set Schedule button. It is the flow's Schedules tab → Create ScheduleSet Up Schedule, with predefined intervals (Every 15 minutes / Every hour / Once a day / Once a week / End of month) or a custom one.

Also documents two things the old text could not: a flow can hold several schedules, they fire independently, and each has a toggle so you can pause one without deleting it.

flows/flows-legacy/ also says "Set Schedule" and is left alone — that is correct for the legacy builder.

management/notifications/

Split by flow type instead of describing only the legacy path.

A Conditional Flow's Notifications tab is edited in place — no "Edit Notifications" button — with three cards: Success, Errors, Processing (longer than usual by a percentage you set). There is no warning notification; Conditional Flows express that through conditions, which is why the old "requires Continue on Error" note doesn't apply there.

The legacy instructions are kept and labelled as legacy.

Also renamed the second of two sections both titled "Flow Notifications" (### 1. and ### 2.).

components/extractors/storage/http/

The page is the reference for the connector the new Getting Started step 2 is built on, so its labels now matter more:

Page said UI says
"Add Table" button Add Row, in a Rows section
"Table Name", derived from the configuration table name Table name, seeded from the row name
"Incremental Load" Incremental load

Added that Read Header already defaults to Read the header from the file(s) header — the setting most readers want and never need to touch.

kai/

The button reads Kai Agent with a Beta pill, not KAI. Fixed on both kai/index.md and kai/getting-started.md.

Verification

  • npm run build clean — 306 pages
  • node scripts/audit-phase2.mjsMISSING IMAGES 0; the 45 broken internal links are pre-existing dev-docs gaps (/overview/encryption/, /overview/api/), none from this change
  • no screenshots changed: every fix is a label in prose

🤖 Generated with Claude Code

Walking the platform for the Getting Started rework (#1071) turned up four places
where these pages describe an interface that has moved on. Each was verified live
in a project on 2026-08-04, not inferred.

**flows/** — scheduling is no longer a "Set Schedule" button. It is the flow's
**Schedules** tab → **Create Schedule** → **Set Up Schedule**, with predefined
intervals or a custom one. Also documented what the old text could not: a flow can
hold several schedules, they fire independently, and each has a toggle so you can
pause one without deleting it. (flows-legacy/ still says Set Schedule and is left
alone — that is correct for the legacy builder.)

**management/notifications/** — split by flow type instead of describing only the
legacy path. A Conditional Flow's **Notifications** tab is edited in place, with
three cards: Success, Errors, Processing. There is no "Edit Notifications" button
and no warning notification — Conditional Flows express that through conditions.
The legacy instructions are kept, labelled as such. Also renamed the second of two
sections both titled "Flow Notifications".

**components/extractors/storage/http/** — the UI says **Add Row** in a **Rows**
section, not "Add Table"; the field is **Table name** seeded from the row name, not
"Table Name" from a configuration table name; **Incremental load**, not
"Incremental Load". Added that **Read Header** already defaults to reading the
file's header, which is the setting most readers want and never have to change.

**kai/** — the button reads **Kai Agent** with a *Beta* pill, not **KAI**.

Found while writing #1071; kept out of that PR because these belong to their own
sections.
@vercel

vercel Bot commented Aug 4, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
connection-docs Ready Ready Preview Aug 6, 2026 11:18pm

Request Review

# Conflicts:
#	src/content/docs/flows/index.md
#	src/content/docs/management/notifications/notifications.md
@Iamfle4ka Iamfle4ka changed the title docs: fix four stale UI labels found by walking the platform docs: fix two stale UI labels found by walking the platform (HTTP rows, Kai Agent button) Aug 6, 2026
@Iamfle4ka

Copy link
Copy Markdown
Collaborator Author

Rebased on main (2026-08-07) — and the scope shrank from four labels to two.

Landed independently, dropped from this PR: flows/ scheduling and management/notifications/ both arrived on main with richer versions than the ones here — screenshots of the Schedules tab and the Create Schedule dialog, the Date & Time vs Triggered split, the Email/Webhook sub-tabs, and the Warnings-card difference between conditional and legacy flows. Main's text is a superset of what this branch proposed, so I took main's side on both conflicts rather than re-landing a thinner version.

Still unlanded, still in this PR:

  • components/extractors/storage/http/ — the connector uses configuration rows, not "Add Table": it is Add Row in the Rows section; the base URL lives under Base URL and Connection Options; and Read Header already defaults to reading the file's header, so the step is to leave it alone.
  • kai/index.md + kai/getting-started.md — the button is Kai Agent, marked Beta, in the project's top bar, not a KAI button in the navigation bar.

Build clean. The Kai label fix is a prerequisite for the Kai pass going into #1071, which references that button by name.

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