Redocly / redoc

📘 OpenAPI/Swagger-generated API Reference Documentation
https://redocly.github.io/redoc/
MIT License
23.48k stars 2.29k forks source link

3rd Level items on left navigation #1225

Open lasithalokuge opened 4 years ago

lasithalokuge commented 4 years ago

Hi Guys,

Is there any way that I can get a 3rd level on the left navigation. image

I'm using 'x-displayName' and markdown headers to generate 1st level and 2nd level items. image

Thanks

lasithalokuge commented 4 years ago

Hi Guys, Any feedback for this?

RomanHotsiy commented 4 years ago

There is no way ATM. We will look into this.

carlos-moreira commented 3 years ago

@RomanHotsiy I don't know if this is related but in my case I'm using the tag grouping feature through the use of 'x-tagGroups', like this:

x-tagGroups:
  - name: Facility Management
    tags:
      - customer
      - loan
      - loan-item
      - lost-found
      - lost-found-item

I'd like to be able to create sub-groups inside tag groups, like this:

x-tagGroups:
  - name: Facility Management
    tags:
      - customer
      x-tagGroups:
      - name: Loan
      tags:
        - loan
        - loan-item
      x-tagGroups:
      - name: Lost Found
      tags:
        - lost-found
        - lost-found-item

That would help a lot with organizing huge docs inside sub-groups of High-level groups.

cleverly87 commented 12 months ago

In terms of large documentation - I could reallydo with having the functionality of the x-tagGroup being the same as a tag in terms of its collapsibility. Will really tidy up a UX for me as I have something well over the region of 100 endpoints and the are all grouped but could just do with that one more level of foldability - I am looking through the code now - I am a professional user of redocly and haven't seen anything in that platform suitable for it either