News for hackers. Stuff that matters.

A comment on RAML – RESTful API modeling language. Parent comment

Re:RAML – RESTful API modeling language by pksunkara on Thursday September 10, 2015 @05:23PM (#10200645)
What do you think about API Blueprint [1]? It is based on Markdown.

[1]: https://apiblueprint.org

[ Parent | on HN ]
Re:RAML – RESTful API modeling language by mpdehaan2 on Tuesday September 15, 2015 @03:35PM (#10222685)
I think Markdown is generally unsuitable as a data format for machines.

YAML strikes a nice balance between machines and people, but I wouldn't want to write a blog post in it.

Markdown is great for blog posts, but APIs are terse.

[ Parent | on HN ]