Eric Yin
Eric Yin is a seasoned supply chain strategist and author, renowned for his expertise in procurement and supplier management. With a career spanning various industries, Eric has developed a deep understanding of the intricacies of supply chain dynamics. Eric is an editor for Apidoke Blog where he also shares his insights on strategic sourcing, supplier relationship management, risk mitigation, and sustainable procurement practices. Eric's practical guidance equips professionals in the logistics industry with the tools needed to drive value and innovation throughout the supply chain.
Articles by Eric Yin
API Documentation Examples: Real-World Docs Worth Studying
Stripe, Twilio, and GitHub publish some of the most studied API documentation on the web. This post breaks down exactly what makes each one work, with concrete lessons you can apply immediately.
October 10, 2026
How to Write a REST API Tutorial for Developers
A REST API tutorial is a narrative learning document that walks a developer from zero to a working result, step by step. This guide covers how to structure one, write the code examples, and publish it alongside your reference docs using Apidoke.
October 7, 2026
API Blueprint Media Types: Documenting Content-Type Negotiation
Content-type negotiation is one of the trickier parts of any REST API to document well. This guide covers every API Blueprint media type mechanic, from the plus-sign format modifier to vendor types, with copy-paste syntax you can drop into Apidoke today.
October 7, 2026
How to Conduct an API Documentation Audit
A repeatable methodology for auditing your API docs, from coverage gaps and accuracy checks to try-it console validation and scoring, using Apidoke.
October 6, 2026
API Blueprint Named Examples and Data Structures: Advanced Patterns
Named examples and data structures let you define a response body once and reference it everywhere. This guide covers the full pattern with copy-paste API Blueprint syntax, real JSON bodies, and how Apidoke renders them in its live three-column viewer.
October 5, 2026
API Blueprint Authentication Schemes: OAuth, API Keys, and Bearer Tokens
A precise, format-level guide to writing OAuth 2.0, API key, and Bearer token authentication schemes directly in API Blueprint files, with real syntax examples and Apidoke try-it console tips.
October 4, 2026
Apidoke vs ReadMe: An Honest Comparison for 2026
ReadMe is the dominant hosted API documentation platform. Apidoke is a self-hostable alternative with a built-in live try-it console and API Blueprint authoring. This comparison covers pricing model, hosting control, the editor experience, and the practical tradeoffs so you can pick the right tool for your situation.
October 4, 2026
API Blueprint vs RAML: Which Format Fits Your Team?
API Blueprint and RAML are both human-readable API description formats, but they take very different approaches to structure and tooling. This guide breaks down the real differences so your team can choose confidently.
September 11, 2026
Documenting Webhooks in API Blueprint
Webhooks push data to your users instead of waiting for them to ask. Documenting them clearly is just as important as documenting your REST endpoints, and API Blueprint gives you a clean, readable syntax for doing exactly that.
September 7, 2026
API Documentation Templates: Ready-to-Use API Blueprint Examples
Ready-to-use API Blueprint templates for the most common REST API patterns, with annotated examples you can paste directly into Apidoke and publish as live, interactive documentation.
September 7, 2026
API Documentation Best Practices for 2026
Concrete, standards-grounded best practices for writing, structuring, and maintaining API documentation in 2026, with real API Blueprint examples and a checklist you can use today.
August 2, 2026
Apidoke vs Redocly: Self-Hosted API Docs Without the Complexity
Redocly is powerful but governance-heavy. If your team wants self-hosted API docs with a live try-it console and no CLI pipeline to maintain, Apidoke is the focused alternative worth evaluating.
July 23, 2026
Reference Docs vs Tutorial Docs: Choosing the Right Type of API Documentation
Not all API documentation does the same job. Reference docs answer 'what does this endpoint do?' while tutorials answer 'how do I build something?' This guide breaks down every major type, shows real examples, and explains how to decide what your API actually needs.
July 17, 2026
API Versioning Strategies (and How to Document Them)
URI versioning, header versioning, query-parameter versioning, and content negotiation each solve the same problem in different ways. This guide compares them honestly and shows you how to document every version so consumers never get lost.
July 15, 2026
Best API Documentation Tools in 2026
A direct comparison of the top API documentation tools available in 2026, covering pricing, self-hosting, live try-it consoles, and format support, so engineering and developer-relations teams can make a confident shortlist decision.
July 3, 2026