APapi·Apr 4, 2017
API Blueprint is much, much cleaner: https://apiblueprint.org
Here's a renderer: https://github.com/danielgtaylor/aglio
It's less feature-rich than Swagger but the format is much less of a nightmare.
In Problems with Swaggerdanielgtaylor
aglio
CoffeeScript2013–2017
danielgtaylor / aglio
aglio
An API Blueprint renderer with theme support that outputs static HTML
5Distinct people
5Mentions
0Explicit recommenders
4.7KGitHub stars
What to know before exploring
What it is
An API Blueprint renderer with theme support that outputs static HTML
GitHub
Where it is used
No documented product use has been verified yet.
What people are saying
No recommendation phrase was found in the indexed comments.
No classified warning is attached to this page. Read the discussions before treating silence as approval.
Also in these discussions
No other repository is repeatedly linked in the same discussions.
This week on Hacker News
Nov 7–Nov 14 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/14/2026, 3:56:07 PM UTC.
No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.
Mentions over time
HN mentions by year5 dated mentions
Observed mentions: 2013-11-19 17:15:31 UTC to 2017-04-04 22:26:05 UTC.
Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.
View mention counts and date ranges
| Period | Start (UTC) | End (exclusive, UTC) | Mentions | Submissions | Comments |
|---|---|---|---|---|---|
| 2013 | 2013-01-01 00:00:00 UTC | 2014-01-01 00:00:00 UTC | 1 | 1 | 0 |
| 2014 | 2014-01-01 00:00:00 UTC | 2015-01-01 00:00:00 UTC | 1 | 0 | 1 |
| 2015 | 2015-01-01 00:00:00 UTC | 2016-01-01 00:00:00 UTC | 2 | 0 | 2 |
| 2016 | 2016-01-01 00:00:00 UTC | 2017-01-01 00:00:00 UTC | 0 | 0 | 0 |
| 2017 | 2017-01-01 00:00:00 UTC | 2018-01-01 00:00:00 UTC | 1 | 0 | 1 |
What Hacker News says
5 sourcesPython community doesn't release new versions nearly as fast. Every major python version release, there is usually a PEP announcing the schedule new version release date far in advance for the community to prepare.
To me, Node community just release new versions fast and furious. If the committers won't, then there are people who jump out and fork the project.
Of course there are the other extreme of long release cycles like Debian but there are good reasons for that.
IMMO, a mature large community of an open source project community should always take the package ecosystem into considering when introducing new versions or breaking changes.
PS: I was pretty annoyed that one of the npm package I used a lot `aglio` is broken again on 5.0.0 after I filed a ticket for the compatibly issue with 4.2.1. This ticket has just been closed a few day
Read the rest
s ago and is only less than two weeks old!
https://github.com/danielgtaylor/aglio/issues/183
We used to start with Aglio (https://github.com/danielgtaylor/aglio) and the API Blueprint format 1A (https://github.com/apiaryio/api-blueprint) provided by Apiary.
We recently moved from Aglio to Apiary.
In Ask HN: What's the best way to write an API spec?Aglio is a pretty slick and simple html render tool for use with Api Blueprint:
https://github.com/danielgtaylor/aglio
In Reviewing common API EditorsAn API Blueprint renderer with theme support
1 points · Open discussion