docs(connectors): add teams/twilio/jira/linear/notion reference docs (drift backlog batch 1)#632
Merged
Merged
Conversation
…(drift backlog batch 1) Burns down the scripts/check_drift.sh baseline from 14 → 9. These five core / API destinations predated the docs/connectors/ convention and had no dedicated reference. Each follows the slack.md shape (blurb / YAML example / config table / auth / common patterns / notes / references) and documents the per-destination specifics that are otherwise only visible in source: - **teams** — plain-text vs adaptive_card JSON payload wrapping - **twilio** — HTTP Basic (SID/token) + E.164 requirement on from_number and the rendered to_template; api.twilio.com/2010-04-01 Messages endpoint - **jira** — create-by-default, issue_id_field-triggered update mode (POST vs PUT on /rest/api/3/issue); Atlassian email + API token Basic - **linear** — GraphQL issueCreate (create-only), team/label/assignee UUIDs + the queries to fetch them - **notion** — properties_template per-type JSON shapes, the Notion-Version: 2022-06-28 header, and the must-share-database-with- integration 404 gotcha; tojson_safe note for datetime/Decimal/UUID drift_baseline.txt updated (5 entries removed; remaining 9 noted in the header). `make check-drift` exits 0. No code changes. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Burns down the
scripts/check_drift.shbaseline from 14 → 9 by writing the first batch of the missing connector docs. These five core / API destinations predated thedocs/connectors/convention and had no dedicated reference.What's documented
Each doc follows the
slack.mdshape (blurb / YAML example / config table / auth / common patterns / notes / references) and captures the per-destination specifics that are otherwise only visible in source:adaptive_cardJSON payload wrappingfrom_number+ renderedto_template, Messages endpointissue_id_field-triggered update mode (POST vs PUT on/rest/api/3/issue), email + API token BasicissueCreate(create-only), team/label/assignee UUIDs + the queries to fetch themproperties_templateper-type JSON shapes,Notion-Version: 2022-06-28header, must-share-database-with-integration 404 gotcha,tojson_safenoteAll five were cross-checked against their config models (
drt/config/models.py) and implementations (endpoints, auth shape, create/update logic) — not written from API memory.Baseline ratchet
scripts/drift_baseline.txtdrops 5 entries; 9 remain (discord/email_smtp/file/github_actions/google_ads/intercom/parquet/sendgrid/staged_upload) — tracked for future batches.Test plan
make check-drift— exits 0 (the 5 new docs are recognized, baseline reduced)Context
Follows the drift-audit automation (#630) — this is the intended workflow: the audit surfaces the doc gap, the baseline tracks it, and batches burn it down over time.
🤖 Generated with Claude Code