HN Hall of Fame Weekly email

RAML - RESTful API modeling language

Screenshot of raml.org captured 2026-07-20
Page preview · captured 2026-07-20

Resurfaced independently across 2 calendar years, with breakout response in 2 of them.

submissions
4
submitters
4
observed span
2013–2015
peak thread · 57 comments
94 pts
latest 20+ return · 2015-09-10
80 pts

Submission timeline

2007–2026

One slot for every year since HN launched. Height is that year's peak points; orange marks a 100+ point or 50+ comment breakout. Select a bar to open its strongest thread.

First comments on top threads

HN comment order

I dont understand what the purpose of this is. I thought the whole point of REST is that it is discoverable at runtime. If you have an "API Spec" doesnt that mean the server owner is now beholden to that spec; that changes to their resources would break compatability with any client written to conform to the spec? I thought everything you needed to write a REST API client is included in the media-type specification and the rel profile? For…

I wrote a Python parser for this called RAMLfications (https://ramlfications.readthedocs.org/en/latest/) I actually built the API console for my company - Spotify (https://developer.spotify.com/web-api/console/) - based off of RAML and am in the process of open sourcing the tech behind it. The first bit being RAMLfications, and the second, called Griffin (https://github.com/spotify/griffin) is a super alpha version of a static doc generator based off of RAML. The next/last bit to open source is the console itself…

The first top-level comment from each of the four biggest threads, in HN’s own order. Excerpts are shortened; open a comment for full context.

Breakout years
2

100+ points or 50+ comments

Total points
178

reference only — not used in Hall rules or ranking

Total comments
112

reference only — not used in Hall rules or ranking

Every submission

DateTitle as submittedByPointsComments
2013-10-02RAML - RESTful API modeling languageFirst breakout · Best threadDanI-S9455
2015-07-22RAML – RESTful API Modeling Languagehliyan30
2015-09-10RAML – RESTful API modeling languageLatest 20+ point returntilt8057
2015-12-04RAML v1.0 (RESTful API Modeling Language)davidbarker10