home.social

#arazzo — Public Fediverse posts

Live and recent posts from across the Fediverse tagged #arazzo, aggregated by home.social.

  1. Are there any tools out there for creating human-readable docs from an OpenAPI Arazzo specification? We use Stoplight for hosting our OAS docs and this doesn't do it automatically, but we could push pre-parsed Markdown to it #api #openapi #oas #arazzo

  2. Are there any tools out there for creating human-readable docs from an OpenAPI Arazzo specification? We use Stoplight for hosting our OAS docs and this doesn't do it automatically, but we could push pre-parsed Markdown to it #api #openapi #oas #arazzo

  3. 🚀 Join me at DevFest Pisa 2025 where I’ll be sharing insights on how to elevate API experiences! 🎤

    My talk, “Overlay and Arazzo: From API Definitions to API Experiences” will explore how we can transform APIs into seamless user experiences.

    📅 When: April 12, 2025
    🕓 Time: 11:40 AM
    📍 Where: MACC - Pisa - Italy
    🗓️ Schedule: devfest.gdgpisa.it/talk/overla

    Hope to see you there! 🎉

  4. It's my first open source release in what feels like years, but I've published a new #PHP library for parsing #openapi Arazzo specifications into plain old PHP objects. I'm hoping to use this as the starting point for future #arazzo related packages, and looking forward to seeing what others may build with it.

    github.com/hskrasek/arazzo-par

  5. API reference documentation changed the way we built integrations, and eventually became part of the driving force for OpenAPI adoption and all the good tooling that flowed from it. As a developer experience specialist, I spend a lot of time thinking about how human users can work with the technical assets in a project. HTML-format API reference documentation does a great job of building that bridge when working on OpenAPI projects, but now I’m using Arazzo and it’s a very new standard with not nearly as many tools available for that format yet – so I built one. […]

    https://lornajane.net/posts/2025/markdown-mermaid-output-for-openapi-arazzo

  6. What is the Arazzo Specification?

    nordicapis.com/what-is-the-ara

    "The Arazzo Specification is an essential missing link between an API being both machine-readable and human-readable. It promises to be an important component in helping developers describe an API function using natural language and having an AI like ChatGPT create the API from scratch." -- #jSimpson

    #api360 #apiDesign #arazzo #apiWorkflow