Generate API from Docs, e.g API blueprint/swagger/raml

[OvermindDL1]

@Crowdhailer

I think API blueprint looks like the leading contender, what experience do people have and can they share any feedback

No experience with it, but it would not be too hard to parse at all (I even have a parsing library that can help!).

@Crowdhailer

Do any of the above support documenting a streaming endpoint, via server sent events (“text/event-stream”) or perhaps websockets

Nope, those go down different paths from the Endpoint.

@benwilson512

At the risk of being a broken record, this is one of the things I like about GraphQL. The same code that ensures data integrity also can generate documentation, and yes, it provides a unified API and documentation structure over both request response and real time data.

+1