Home Getting Started Human Spec LLM Spec

The Authors

A tale of two renegades who dared to simplify API documentation

Chapter 1: The Austin Origins

It all started in Austin, Texas, where the breakfast tacos flow freely and the tech meetups never end. Two souls, drawn together by a shared love of Java and open technologies, found themselves at a particularly rowdy SXSW afterparty in 2008.

One was pitching the merits of RESTful architecture to a confused bartender. The other was drawing UML diagrams on cocktail napkins. It was love at first semicolon.

Together, they embarked on outrageous adventures across the Austin startup scene. They listened to pitches about blockchain-powered dog walking apps, AI-driven artisanal pickle optimization platforms, and at least seventeen different "Uber for X" concepts. Through it all, they brought sanity to startup teams who had lost their way in a forest of over-engineered microservices.

WANTED
For Crimes Against Complexity
Geofredo
Geofredo
a.k.a. "The Simplifier"
REWARD: One Valid OpenAPI Spec
WANTED
For Markdown Mischief
Jaime
Jaime
a.k.a. "The Documentation Desperado"
REWARD: One Properly Nested YAML File

Chapter 2: The Great Escape

Word travels fast in the API community. When rumors spread that two mad geniuses were working on a format that could replace thousands of lines of YAML with simple, readable Markdown, the establishment took notice.

First came the strongly-worded GitHub issues. Then the passive-aggressive tweets. Finally, a formal delegation from the OpenAPI Initiative showed up at their favorite taco truck, demanding answers.

"You can't just... make things simple," they sputtered. "Where's the ceremony? The nested brackets? The existential dread of a missing comma on line 4,847?"

CURRENT STATUS: IN HIDING

The authors are currently believed to be somewhere in the mountains of Colorado, subsisting on craft beer and the satisfaction of a clean, human-readable specification format. A posse consisting of disgruntled OpenAPI committee members and a surprisingly angry contingent from Postman continues to search for them.

Chapter 3: The Promise

From their undisclosed location (somewhere between Breckenridge and Boulder, near excellent hiking trails), the authors have issued this statement:

"We shall emerge from hiding once we witness significant adoption of MAPI across the developer community. When API documentation is finally readable by both humans AND machines without requiring a PhD in YAML archaeology, we will return. Until then, we remain in the shadows, writing Markdown and dreaming of a simpler world."

They've asked that supporters leave signs of adoption (GitHub stars, tweets, passive-aggressive Slack messages to their DevOps teams) as signals that the coast is clear.

Official Legal Disclaimer

The authors wish to clearly state that there MAY or MAY NOT be any relation to Satoshi Nakamoto. They can neither confirm nor deny any involvement in cryptocurrency, though they do find it suspicious that Bitcoin's whitepaper was also written in a remarkably readable format. Coincidence? They're not saying.