What is stories?

OpenAPI Initiative Stories is a community workspace for planning, drafting, and publishing articles about the OpenAPI Specification. Rather than being a software project, it's a collaborative editorial process hosted on GitHub. The goal is to help more people understand what the specification can do by producing a steady stream of blog posts, videos, and other content. The repository works like a newsroom workflow built with GitHub's issue tracking and project boards. Anyone can submit a story idea as an issue. From there, ideas move through stages: they start as topics, evolve into interview notes and drafts, get refined through structural decisions and copy editing, and eventually reach publication on the OAI blog or other channels. Each stage has its own status labels so contributors can see what a story needs next. The current queue includes stories about API copyright, how companies like Xero and GitHub adopted the specification, and tools for formatting and comparing API definitions. Some are just topic ideas needing a champion, while others already have drafts in progress. This project is aimed at people who use OpenAPI and want to contribute to the community through writing rather than code. They need interviewers to talk with tooling makers and practitioners, writers to turn those conversations into finished articles, and editors to polish drafts before publication. If you have a story idea or want to help move an existing one forward, you can jump into a project board or open an issue to get involved.