Troubleshooting

The GitHub check fails on my pull request

The Corpole check wants every pull request to cite existing, non-retired record or work item codes.

For: Team developer, Project lead

Why it fails

  • The pull request cites no code at all.
  • It cites a code that does not exist.
  • It cites a Retired record. A retired decision cannot come back through a merge.
  • It warns, without failing, when a cited record is only Draft or Approved.

Fix it

  • Put the story or record code in the pull request title or description, e.g. ST-1A2B3C or FR-7C21A4.
  • For a change that no requirement governs (a typo, formatting, a rename, a dependency patch) add the label no-requirement. It must not change behaviour.
  • If the check cannot reach Corpole at all, the repository secret CORPOLE_TOKEN is missing or revoked; a person with the integrations permission creates a service token for it.