Skip to content

docs: Stops claiming webhook signature verification that does not exist - #23

Merged
wcislom merged 1 commit into
mainfrom
chore/documentation-polishing
Oct 16, 2026
Merged

wcislom merged 1 commit into
mainfrom
chore/documentation-polishing

Conversation

@wcislom

@wcislom wcislom commented Oct 16, 2026

Copy link
Copy Markdown
Owner

Summary

#22 removed the signature v2 parts from the docs, but a few places still said the webhook is signed and verified,
and the only warning that it is not was gone. A reader who saw "Ingress verifies it" and then opened
TeamtailorWebhookEndpoint would find no verification. This PR makes the docs match the code.

  • README: the diagram shows a plain webhook instead of signed webhook. Known limitations again says that
    Ingress does not verify the Teamtailor webhook signature (v2) yet and accepts unsigned webhooks.
  • docs/architecture.md: key flow step 1 no longer says the webhook is signed and verified. The same
    limitation is listed under Known limitations, so the README link points to it.
  • docs/diagrams.md: the sequence diagram drops (signed) and verify from the Ingress step.
  • .claude/rules/teamtailor.md: the Signature v2 section, which holds Teamtailor's format, is marked
    "Not implemented yet: the next step after the MVP", and "Verification lives in" is now "belongs in".

Docs only, no code change.

@wcislom
wcislom merged commit b045e32 into main Oct 16, 2026
3 checks passed
@wcislom
wcislom deleted the chore/documentation-polishing branch October 16, 2026 16:07
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