Skip to content

Data source credits: show source_attributions wherever the data goes - #68

Open
DrAlexHarrison wants to merge 1 commit into
mainfrom
source-credit
Open

DrAlexHarrison wants to merge 1 commit into
mainfrom
source-credit

Conversation

@DrAlexHarrison

Copy link
Copy Markdown
Member

What changes, in plain words

docs.saturday.fit tells API users and AI-assistant builders about the new credit lines on workouts: when a workout came from a source whose terms require credit (for example a Garmin watch, relayed by intervals.icu), Saturday sends source_attributions such as ["Garmin Edge 1040"], and they must show it word for word next to the workout and anything they build from it.

Merge order: merge this only after fuel-backend #1806 is deployed to prod (partner-api). This repo deploys on merge (Mintlify), so merging first would document a field the live API does not send yet. Leave unlabeled: fuel-backend #1806 stacks on #1803, which is held for Alex.

Pages

  • guides/attribution.mdx: new "Data source credits" section: the field, the display duty (verbatim, untranslated, visible without interaction, carried downstream), and a table of every response that carries it.
  • guides/coach-api.mdx: roster and digest rows carry the field; an intervals.icu workout recorded on Garmin carries a Garmin line; the webhook example shows source_attributions, which the events already carry.
  • guides/activities.mdx: one line on the field for an athlete's synced activities.
  • guides/mcp-integration.mdx: AI agent guidelines add "show source_attributions lines".

Checks

check-docs-drift.py --backend <fuel-backend #1806 worktree>: clean. check-engine-constants.py, check-app-claims.py, test-response-examples.py: clean. mint broken-links --check-anchors: no broken links.

🤖 Generated with Claude Code

https://claude.ai/code/session_01RdmWd4TJTQMDjLtmVXcBu1

Document the source_attributions lines on the athlete's activities, insights,
Coach API sessions, reports, roster rows and coach webhook events, and the
duty to show them verbatim beside the data and anything built from it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RdmWd4TJTQMDjLtmVXcBu1

Ci-From: amac
Ci-Session: 47cac48e-1e74-4d9d-a691-30d517a06c2f

This branch has not been deployed

No deployments
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