Skip to content

Rewrite README for a proper open-source landing page#125

Merged
dreampowder merged 1 commit into
masterfrom
readme-overhaul
Jun 1, 2026
Merged

Rewrite README for a proper open-source landing page#125
dreampowder merged 1 commit into
masterfrom
readme-overhaul

Conversation

@dreampowder

Copy link
Copy Markdown
Owner

The previous README was out of date — it referenced a removed Strava() / isInDebug initialization API, carried a "heavy refactoring" warning, and listed endpoint names that no longer match the code.

This rewrite is accurate to the current package and structured for an open-source landing page:

  • Badges: pub version, CI status, license.
  • Overview + TOC: feature bullets, links to the OpenAPI specs and example app.
  • Quick start: real StravaClient construction + authentication.authenticate + a repository call.
  • Platform setup: correct Android manifest + iOS plist (incl. native-app query scheme), web-unsupported note.
  • Authentication: scopes list, forceShowingApproval/preferEphemeral, and a note on automatic token storage + refresh.
  • Making API calls: repository table + examples (activities, segments, streams-by-type).
  • Error handling: Fault example.
  • Supported endpoints: collapsible, accurate to the current repositories.
  • Example app, Contributing, Acknowledgements, License.

Docs only — no code changes.

🤖 Generated with Claude Code

The old README was stale (referenced a removed Strava()/isInDebug API, a
"heavy refactoring" warning, and outdated endpoint names). Replace with an
accurate, structured README:

- Badges (pub, CI, license), feature overview, table of contents
- Quick start using the real StravaClient + repository API
- Android/iOS setup, authentication + scopes, token refresh notes
- Making calls (repository table + examples), Fault error handling
- Collapsible supported-endpoints list matching the current API
- Example explorer app instructions, contributing, acknowledgements, license

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dreampowder
dreampowder merged commit 4800bf2 into master Jun 1, 2026
2 checks passed
@dreampowder
dreampowder deleted the readme-overhaul branch June 1, 2026 20:30
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