How to handle one off verbs and views?

[sirwolfgang]

I apologize if I missed this in the documentation. I am trying to find a good way to express one off paths for verbs and other views. In these cases, examples below, I don't think it makes sense to separate them by a header, but am required to in order to specify the URL.

# Group Items
## Items [/items]
### Retrieve Items [GET]

## Item [/items/{id}]
### Retrieve an Item [GET]

## SKUs [/items/sku/{sku_number}]
### Retrieve an Item by SKU [GET]

## Inventories [/items/{id}/inventories]
### Retrieve an Item's Inventories [GET]

## Events [/items/{id}/events]
### Retrieve an Item's Events [GET]

## Warehouses [/items/{id}/warehouses]
### Retrieve an Item's Warehouses [GET]

[LilyMGoh]

@sirwolfgang If you don't care about the action names, you can use a shortcut like so:

# Group Items

# GET /items
+ Response 200 (text/plain)
...

# GET /item
+ Response 200 (text/plain)
...

Let me know if this is what you are looking for.

[sirwolfgang]

I somewhat care about naming the actions, but when I do that I get this:

Which is being rendered by the Atom.io viewer. Might this be a bug with the viewer?

[Anahkiasen]

Wondering the same thing, there should be a way to name one-off actions, like:

# Get an user [GET /users/{user}]

Or something

[pksunkara]

@sirwolfgang @Anahkiasen Do you guys think you can make use of the features proposed in #88?

[Anahkiasen]

Would work for me yup

[zdne]

Addressed in #88.