Skip to content

docs(bitrise-platform/accounts): fix docs-vs-implementation drift in the accounts section - #183

Merged
zoltan-baba merged 2 commits into
mainfrom
docs-staleness-platform-accounts
Aug 14, 2026
Merged

docs(bitrise-platform/accounts): fix docs-vs-implementation drift in the accounts section#183
zoltan-baba merged 2 commits into
mainfrom
docs-staleness-platform-accounts

Conversation

@zoltan-baba

Copy link
Copy Markdown
Collaborator

Summary

  • Ran a docs-vs-implementation validation of docs/bitrise-platform/accounts (19 articles, incl. SAML SSO/SCIM sub-pages) against bitrise-website (and bitrise-api/scim-service for secondary checks).
  • Rewrote the profile-edit and notification-preferences procedures to match the current UI (two S4 findings — both confirmed via git history as deliberate implementation changes, not regressions).
  • Fixed stale button/field labels across the accounts and SAML SSO/SCIM articles: Name, Copy and close, Change Password, Configure SSO, SSO URL, Connect with IdP, Collaboration.
  • Removed 5 outdated screenshots and a reCAPTCHA reference that no longer applies (removed from the product in 2024).
  • Generalized the SAML SSO plan-eligibility wording in the shared partial (src/partials/caution-saml-sso-restrictions.mdx) so it doesn't overstate eligibility as pricing changes.
  • Left two known-open items in configuring-scim.mdx untouched: one unresolved claim about SCIM role-clearing semantics (needs the SCIM service owners to confirm) and one product-question about documenting the "rde" role family.

Test plan

  • node scripts/check-links-source.js run on every edited file — no broken internal links or anchors.
  • Full validation reports and scoreboard available at docs-validation/results/bitrise-platform/accounts/ (not part of this PR) for reference.
  • Docs site build / preview (reviewer to confirm rendering, especially the removed admonitions and screenshot removals).

…the accounts section

Fixes stale procedures, labels, and screenshots across the accounts and
SAML SSO/SCIM articles found by a docs-validation run: rewrote the
profile-edit and notification-preferences flows to match the current
UI, corrected stale button/field labels (Name, Copy and close,
Change Password, Configure SSO, SSO URL, Connect with IdP, Collaboration),
removed outdated screenshots and a removed reCAPTCHA reference, and
generalized the SAML SSO plan-eligibility wording in the shared partial.
…tive guide

Missed in the previous docs-validation cleanup pass: the field is
labeled SSO URL and the page is titled "Single sign-on", not "Enable
Single Sign-On".
@github-actions

Copy link
Copy Markdown

@zoltan-baba
zoltan-baba merged commit 8fad69c into main Aug 14, 2026
2 checks passed
@zoltan-baba
zoltan-baba deleted the docs-staleness-platform-accounts branch August 14, 2026 12:35
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