A daily tech reading list covering AI agents, platform engineering, API docs, AI UX, and cloud performance trends.
Learn how to customize ASP.NET's default OpenAPI schema name generation to resolve naming conflicts between models in different namespaces.
A tutorial on enabling OpenAPI/Swagger support in .NET Isolated Azure Functions, covering package installation and attribute configuration.
A developer reflects on the lost joy of learning through API docs and tutorials in the age of AI coding assistants, advocating for slowing down to enjoy the process.
TypeDoc's new {@includeCode} tag allows testing code examples in documentation by referencing specific regions from external test files.
Explains the shift from Swashbuckle to built-in OpenAPI in ASP.NET 9 and how to handle API documentation.
Explores alternatives to Swagger for API documentation in ASP.NET 9, including Swashbuckle, NSwag, and Scalar.
Explores the new Microsoft.AspNetCore.OpenApi package in .NET 9 for generating OpenAPI documents, comparing it to NSwag and Swashbuckle.
Explores the continued relevance of Azure API Management's developer portal, covering its key features, new audit logging, and upcoming WordPress integration.
Explains why OpenAPI definitions break in ASP.NET Core Minimal APIs after refactoring and how to fix them by preserving metadata.
Practical tips for writing technical documentation that is optimized for LLM question-answering tools, improving developer experience.
A developer argues for minimal, strategic code commenting, using examples to show how clear naming and structure can often replace verbose comments.
Analyzes gaps in current API documentation tools for TypeScript libraries and proposes the need for a standardized API model.
Explains JEP 413 for Java 18, enabling executable, testable code snippets in JavaDoc from external files like src/test/java.
Explains JEP 413 for Java 18, enabling executable, testable code snippets in JavaDoc from external files like test directories.
A guide to integrating Swagger UI for documenting REST APIs in Azure Function v2 and v3, covering setup, configuration, and code examples.
A guide on adding ReDoc code examples to Django REST Framework API documentation using the drf-yasg package and custom schema generation.
Explains how to hide specific controllers or actions from Swagger/OpenAPI documentation in ASP.NET Core using conventions.
A guide to using Test-Driven Development principles to create and maintain accurate, always-in-sync documentation for RESTful APIs.
Tips for building production-ready REST APIs with Node.js, covering HTTP methods, status codes, documentation, and framework choices.
