Mar 3 · 7 min read · Documentation Tools for Developers: Generators, API Docs, and Wikis Good documentation is the difference between a library people adopt and one they abandon after five minutes. But "documentation" is not one problem -- it's several. You need prose do...
Join discussionMar 3 · 5 min read · API Design Tools: OpenAPI, Swagger, and API-First Development Most APIs are designed by accident. Someone writes a handler, returns some JSON, and the "API" is whatever the code happens to produce. API-first development flips this: you design the API...
Join discussionFeb 12 · 10 min read · Why Traditional API Documentation Approaches Fail at Scale Manual documentation maintained separately from code becomes stale within weeks. Wiki pages, Markdown files in repositories, and Postman collections diverge from actual implementation as team...
Join discussionFeb 12 · 10 min read · API Documentation Auto-Generation with OpenAPI and Swagger: A Modern Implementation Guide API documentation auto-generation has become a critical requirement for engineering teams managing microservices architectures and distributed systems in 2025. ...
Join discussionFeb 12 · 12 min read · Article Body Modern API development teams face a critical decision that impacts developer experience, integration speed, and long-term maintainability: choosing the right API documentation specification. With microservices architectures dominating en...
Join discussionFeb 12 · 6 min read · Swagger Codegen: Generate SDKs from OpenAPI Specs The API That Broke Everything (And How Documentation Could Have Saved Us) Our undocumented API changes broke 50 client apps. Here's what we learned the hard way. Table of Contents API Development 202...
Join discussionFeb 9 · 2 min read · Today ChatGPT lied to me, so I’m setting the record straight. This is my question: “If an endpoint in an OpenAPI spec has multiple tags, what will Swagger Codegen do?”. Because Swagger Codegen organized the generated code into api/tag_name_api files....
Join discussion
Feb 8 · 6 min read · As an engineering lead, I spent most of my time architecting systems, writing issues, and translating business requirements into clean technical requirements which involve some form of API documentation and authoring DTOs. Defining the API as a contr...
Join discussionFeb 7 · 3 min read · Introduction If you’ve worked with ASP.NET Core APIs, you’ve definitely hit /openapi/v1.json (or /swagger/v1/swagger.json) at least once. For a long time, I assumed this file was: generated at startup, or stored somewhere on disk, or magically han...
Join discussionJan 27 · 1 min read · If you’re learning .NET, here’s a roadmap that actually leads to real skills. What we built A Todo API with: REST endpoints (GET/POST/PUT/DELETE) Middleware (logging + global errors) Dependency Injection Swagger EF Core + SQLite persistence Int...
Join discussion