danielgtaylor / danielgtaylor/aglio

Condensed-nav tweaks for anonymous Resources

Open
#361 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
CoffeeScript
Stars
4.7k
Forks
471
PR merge metrics
No merged PRs in 30d

Description

API Blueprint allows `Resource` sections to be anonymous, as described in the [specification](https://github.com/apiaryio/api-blueprint/blob/master/API%20Blueprint%20Specification.md#definition-6).

```md
#### Definition
Defined by an [URI template][uritemplate]:

#
```

### Current behavior

With this configuration, Aglio renders the left nav with the default label "Resource".

```apib
# Group QA

## /v1/tests

### Get tests [GET]
Get all tests

### Add test [POST]
Add a test
```
currently renders as:

| **QA** |
| :--- |
| Resource |
|     Get tests |
|     Add test |

### Proposed change

With "condensed nav" enabled, Aglio could detect anonymous resources and move the `Action` labels to the primary position.

| **QA** |
| :--- |
| Get tests |
| Add test |

Without condensed nav, the current behavior would remain as-is.

Contributor guide

No contributing guide indexed for this repository

Research direction

The issue names no implementation files, tests, or entry points. Start by locating the condensed-nav rendering path for anonymous API Blueprint Resources, then verify that condensed navigation promotes Action labels while the non-condensed output keeps the existing "Resource" label.

Written by the indexing model from the issue text.

Assessment

Tech stack
coffeescript
Domain
frontend
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.