API the Docs Paris 2018
as the organisers put it
API The Docs Paris 2018. One-day conference about API documentation and developer portals.
| title | author | length |
|---|---|---|
| SDK or Not | LukasRosenstock | 27m |
Argues for shipping curated client libraries versus API-only by walking through a built SDK generator that emits idiomatic clients for JavaScript and Python… | ||
| Security Considerations in API Docs | BridgetKhursheed | 23m |
Presents evidence that many public API documentation repositories leak real credentials (about 30% in a 200-repo sample) by using a regex-based scanner plus… | ||
| Starting From Scratch | Eva Casado | 29m |
Shows how to build a production-ready API from zero in eight weeks using Node.js, OpenAPI and Postgres. Covers implementing token authentication and idempotent… | ||
| StellaCrowhurst APITDParis2018 | StellaCrowhurst | 23m |
Machine captions are largely unintelligible Spanish fragments and music cues, so no clear claim, tool, metric, or demo appears in the text; what surfaces are… | ||
| Release Notes | KenDavies | 22m |
Argues that release notes should be machine-generated from Conventional Commits and demonstrates a CI job that runs a git-log parser and changelog-generator to… | ||
| MovingFromGitHubWikiToOwnDocsServer | KarenSawrey | 16m |
Migrates 120 wiki pages off GitHub and proves a full docs site on a containerized server using Hugo + Netlify for static builds, Docker for local testing and… | ||
| OpenAPIspec | TaylorBarnett | 20m |
Claims that OpenAPI becomes a working contract: teams use it to prototype, mock and test before code exists, not just to auto-generate reference. Tooling… | ||
| nothing matches | ||