danielgtaylor / danielgtaylor/aglio

Display of resource headings in navigation (apiary vs. aglio)

Open
#309 1 comment 1 reaction 0 assignees View on GitHub
Dominant language
CoffeeScript
Stars
4.7k
Forks
471
PR merge metrics
No merged PRs in 30d

Description

Hey,

I stumbled across a rendering issue in the navigation while starting to sketch an API on apiary.io and transferring the results (via "Download API Blueprint") to `aglio`.

This is the said documentation on apiary.io: http://docs.laddrtest.apiary.io/#reference/laddrs
Notice the sections for `Team` and `Teams` in in the navigation.

If I render the exported blueprint file with `aglio` (2.3) the menu structure looks different.

The `Team` and `Teams` headings get omitted and instead the headings for the actions ("Retrieve a Team", "List Teams") are moved to the top level. (I tried different themes but the issue remained).

If the syntax is correct and the renderer for apiary isn't simply more forgiving than `aglio` then this looks like a bug, right?

---

This is how `aglio` renders the menu: [![aglio-nav.png](https://s11.postimg.org/a3ds4ntn7/aglio_nav.png)](https://postimg.org/image/5u922hqdr/)

And the corresponding HTML:

```


```

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.