Taxi: A language for documenting data models and the contracts of APIs
Hey folks.  Creator of Taxi here.  Pretty chuffed to wake up and find Taxi on the front page of HN.<p>We built Taxi originally as a &quot;Better OpenAPI&quot;, being frustrated with the signal-to-noise ratio of OpenAPI &#x2F; Swagger&#x27;s format.<p>However, over the years, we&#x27;ve found it shines when used to describe how data and APIs from different teams &amp; systems can interoperate.<p>Rather than describing an API endpoint as accepting a &quot;String&quot;, it&#x27;s much more descriptive to say &quot;EmailAddress&quot;, or &quot;WorkEmailAddress&quot;.  By using these same scalar types to enrich models in other systems, you can start building pretty powerful knowledge graphs of how everything in your org hangs together.<p>Happy to answer any questions.