Where the Wild Docs Are
Where should open source documentation live? README or on a static site?
Read
Taylor Barnett
Aug 8, 2019
Learn how to design a beautifully branded workspace with Stoplight Platform. Register for the interactive workshop here.
Taylor Barnett is a community engineer and developer relations expert. She's passionate about building great developer experiences with an emphasis on empathy and inclusion within APIs, documentation, support, and other community-focused projects. She has spoken at conferences such as O'Reilly OSCON, API Strategy & Practices, DevXcon, and various local meetups about APIs, developer experience, SDKs, and building developer communities.
Where should open source documentation live? README or on a static site?
Ruleset improvements and more CLI focus provide a better experience
An open source, flexible JSON linter with out of the box support for the OpenAPI Specification
Avoiding oversimplification, writing good error messages, and having better word choice
How do people actually read documentation and how to write documentation and code samples to maximiz...