✳flâneur — a map of the web's best reading
Ship types, not docs
shiptypes.com · 2,793 words · saved by 1 readers
Types are the contract between services, docs are not
Ship types, not docs Ship types , not docs Types are the contract between services, docs are not by Boris Tane Documentation v2 · 4 months ago POST /api/v2/orders userId : string optional items : Item[] amount : string address : object zipCode : number street : string user_name : string // No mention of required headers // No mention of currency field // Last updated by @sarah (left the company) Implementation v3 · current // requires X-Api-Version header app . post ( '/api/ v3 /orders' , async (req, res) => { const { customerId , items, amount, address, currency } = req.body; //
Explore this link on the map →saved by
related reading
- Best practices for Claude Code - Claude Code Docsanthropic.com
- GitHub - webrpc/webrpc: webrpc is a schema-driven approach to writing backend services for modern Web apps and networks · GitHubgithub.com
- Cookbookcookbook.openai.com
- Typst: The new foundation for documentstypst.app
- TypeScript: Documentation - The Basicstypescriptlang.org
- BAMLboundaryml.com
- BAMLboundaryml.com
- How Stripe creates the best documentation in the industrymintlify.com
- Writing Culture is Agent Infrastructure - Sohail Mohammadsohailmo.ai
- TypeScript: Documentation - TypeScript 3.7typescriptlang.org
- AGENTS.mdagents.md
- AI Elementselements.ai-sdk.dev