Expose more description information

[dim]

See https://github.com/ruby-grape/grape/blob/master/lib/grape/dsl/desc.rb. We should expose:

• headers - HTTP headers this method can accept
• hidden - hide endpoint from doc if set
• deprecated
• produces + consumes - MIME types
• http_codes - we should expose this
• entity - please note that success is now just an alias, we should use entity instead

Here's an idea on format:

### `GET /resources`

Description first, append a period unless `ends_with?(/[[:punct:]]/)`.

- **Status**: **DEPRECATED**
- **Resource**: Array of [Mock:Foo](#mock-foo)
- **Security**: `required=["foo/bar.baz", "foo/bar.qux"]`

**Content Types**:

- **Consumes**: `application/json`, `application/yaml`
- **Produces**: `application/json`, `application/pdf`

**Headers**:

- **X-Auth-Token**: Validates your identity (required)
- **Per-Page**: number of items per page

**Params**:

| Field                | Type       | Description                              |
| -------------------- | ---------- | ---------------------------------------- |

Omit sections if there's no informations about the,