app/stories/developer/DEV-002-sdk-documentation.md

# Comprehensive SDK Documentation

**ID:** DEV-002
**Priority:** High
**Status:** Planned

## User Story
As a developer, I want comprehensive documentation for the IDP client SDK so that I can integrate authentication into my applications quickly and correctly.

## Acceptance Criteria
- [ ] Getting started guide with installation and setup
- [ ] Authentication flow explanations with diagrams
- [ ] API reference for all client methods
- [ ] Code examples for common use cases
- [ ] TypeScript type definitions documented
- [ ] Error handling guide with error codes
- [ ] Migration guides for version upgrades
- [ ] Interactive API playground/sandbox

## Technical Notes
- `@idp.global/sdk` contains the browser and server SDK surfaces
- The SDK README has basic usage but needs expansion
- Generate API docs from TypeScript using TypeDoc
- Host documentation on dedicated site or GitHub pages
- Consider OpenAPI/Swagger spec for REST endpoints

## Related TODOs
- New feature - documentation enhancement