Skip to content

docs: fix broken callbacks anchor in FAQ - #111

Merged
fuhrysteve merged 1 commit into
masterfrom
fuhry/sync-faq-anchor
Aug 4, 2026
Merged

docs: fix broken callbacks anchor in FAQ#111
fuhrysteve merged 1 commit into
masterfrom
fuhry/sync-faq-anchor

Conversation

@fuhrysteve

Copy link
Copy Markdown
Contributor

Sync of LakeEriePartners#13, which is already merged there.

Two links in docs/faq.md pointed at client-usage.md#callbacks. There's no "Callbacks" heading in that file — the sections are Lifecycle callbacks (the options reference) and Lifecycle callbacks (in detail). Both now target the detail section, which is what the surrounding prose is talking about: the functions and objects each callback hands you.

The anchor is broken both on GitHub and on developers.tpastream.com, which renders these docs by cloning this repo at build time (scripts/clone-sdk-docs.sh, SDK_REPO defaults to TPAStream/stream-connect-js-sdk). That's why the fix needs to land here and not only on the LakeEriePartners side — the merged PR there doesn't reach the published docs on its own.

Verification

  • ## Lifecycle callbacks (in detail) exists at docs/client-usage.md:209 on this branch, and client-usage.md is identical between the two repos, so the target resolves.
  • After this change docs/faq.md is byte-identical to LakeEriePartners master.
  • Built developer-docs against a branch carrying this fix: the broken-anchor report goes to zero. Before it read:
- Broken anchor on source page path = /sdk/faq:
   -> linking to /sdk/client-usage#callbacks

Docs-only; no source or bundle changes.

Two links in the FAQ pointed at client-usage.md#callbacks. There is no
"Callbacks" heading in that file — the sections are "Lifecycle
callbacks" (the options reference) and "Lifecycle callbacks (in
detail)". Both links now target the detail section, which is what the
surrounding prose is describing: the functions and objects each
callback hands you.

The anchor is broken on GitHub and in developers.tpastream.com, which
renders these docs via clone-sdk-docs.sh and flags it as a broken
anchor on every build.

Sync of LakeEriePartners#13; docs/faq.md is byte-identical to that
repo's master after this change.
@fuhrysteve
fuhrysteve merged commit e637ed1 into master Aug 4, 2026
4 checks passed
@fuhrysteve
fuhrysteve deleted the fuhry/sync-faq-anchor branch August 4, 2026 19:59
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