Skip to content

Add troubleshooting guide for commit issues#474

Closed
kmccarp wants to merge 4 commits intomainfrom
kmccarp/commit-troubleshoot
Closed

Add troubleshooting guide for commit issues#474
kmccarp wants to merge 4 commits intomainfrom
kmccarp/commit-troubleshoot

Conversation

@kmccarp
Copy link
Copy Markdown
Contributor

@kmccarp kmccarp commented Feb 19, 2026

Summary

  • Adds a new troubleshooting doc covering the 8 most common commit/PR failure scenarios on the Moderne Platform, sourced from extensive Slack research (2800+ threads)
    • Covers: LST/git mismatches (the number 1 issue), SCM auth/token problems, rate limiting, duplicate PRs, archived repos, NON_FAST_FORWARD errors, PR branch conflicts, and empty commit results
  • Includes searchable error messages in quote blocks so users can find the right section quickly

Test plan

  • yarn build passes with no new broken links or warnings
  • Review doc renders correctly on the Docusaurus dev server
  • Verify sidebar placement (appears after "Working with commits and PRs")
  • Review content accuracy with platform team

Covers the most common commit and PR failure scenarios on the
Moderne Platform: LST/git mismatches, SCM auth and token issues,
rate limiting, duplicate PRs, archived repos, NON_FAST_FORWARD
errors, PR branch conflicts, and empty commit results.
Move Azure DevOps service principal and missing scmAccessTokens
issues into a dedicated API-only section, since they only apply
when committing via the GraphQL API.
… doc

Keycloak session expiry logs users out of the platform entirely — it's
not a commit-specific failure mode and doesn't belong in this guide.
@kmccarp
Copy link
Copy Markdown
Contributor Author

kmccarp commented Mar 11, 2026

I have not had a chance to get back to this and it will change with saas 2, so closing for now.

@kmccarp kmccarp closed this Mar 11, 2026
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