wehub-resource-sync
27 lines
549 B
Markdown
27 lines
549 B
Markdown
# API Documentation Principles
|
|
|
|
> Good docs = happy developers = API adoption.
|
|
|
|
## OpenAPI/Swagger Essentials
|
|
|
|
```
|
|
Include:
|
|
├── All endpoints with examples
|
|
├── Request/response schemas
|
|
├── Authentication requirements
|
|
├── Error response formats
|
|
└── Rate limiting info
|
|
```
|
|
|
|
## Good Documentation Has
|
|
|
|
```
|
|
Essentials:
|
|
├── Quick start / Getting started
|
|
├── Authentication guide
|
|
├── Complete API reference
|
|
├── Error handling guide
|
|
├── Code examples (multiple languages)
|
|
└── Changelog
|
|
```
|