Skip to content

docs(connectors): the upstream records page refreshes itself after Discover and Sync - #16297

Merged
blakeaowens merged 2 commits into
devfrom
docs/upstream-connector-operation-feedback
Oct 10, 2026
Merged

blakeaowens merged 2 commits into
devfrom
docs/upstream-connector-operation-feedback

Conversation

@blakeaowens

Copy link
Copy Markdown
Contributor

Description

Updates the upstream connector docs:

  • connectors/upstream/manage_operations.md: removes "refresh the page". A manual Discover or Sync runs in the background and the page reloads its Records and Operations when it finishes. The connectors service runs one operation at a time across all Connectors, so a manual run can wait behind another one; the page keeps checking for up to two hours and then asks the reader to refresh later. Adds Pending to the Status values, and a new "When a manual run is refused" section (the three-per-minute throttle, and the connectors service being unreachable).
  • connectors/upstream/manage_records.md: fixes the empty "Editing Records" link (now points to "Change the Mapping of a Record") and replaces the stale "blue arrow" wording with the record's menu next to its State.

Test results

Documentation only, no code. Every link and anchor the change adds resolves within the docs tree, and the added text has no em dashes or version-specific wording.

Documentation

This PR is the documentation change.

blakeaowens and others added 2 commits October 9, 2026 15:57
…er and Sync

Manage Operations: the page reloads its records and operations when a manual
Discover or Sync finishes (no manual refresh), the Status column and filter
include Pending, and a new section explains the two common refusals (the
three-a-minute limit and an unreachable connectors service).

Manage Records: the empty Editing Records link points at Change the Mapping of
a Record, and the row menu is the three-dot menu next to the State, not a blue
arrow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…eration

The connectors service runs one operation at a time, so the records page
keeps checking for a started run for up to two hours, then says so.
Scheduled runs that start while the page is open show on the next load.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@blakeaowens
blakeaowens requested a review from Maffooch as a code owner October 9, 2026 21:08
@blakeaowens blakeaowens added this to the 3.4.100 milestone Oct 9, 2026
@github-actions github-actions Bot added the docs label Oct 9, 2026
@blakeaowens
blakeaowens added this pull request to the merge queue Oct 10, 2026
Merged via the queue into dev with commit c4882a7 Oct 10, 2026
39 of 41 checks passed
@blakeaowens
blakeaowens deleted the docs/upstream-connector-operation-feedback branch October 10, 2026 03:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants