redoc icon indicating copy to clipboard operation
redoc copied to clipboard

Add tooltip functionality to Navigation Menu

Open NicBunn-PlutoFlume opened this issue 3 years ago • 4 comments

Describe the problem to be solved We are using Redocly to document our client-facing APIs. At the moment we have a table under each main Navbar heading that summarises all of its subheadings as a way to give readers a quick reference and help them find what they're looking for. Maintaining this everytime we add an API to our docs is resulting in a bit of bloat in the documentation and feels a little clunky

Describe the solution you'd like It would be great to add tooltip functionality along with the 'summary' and 'description' parameters for 'paths'. This way, when users are navigating the available submenus they could hover to get a quick description without having to fully invest into each option

Describe alternatives you've considered

  • Tables at the beginning of each section/heading
  • Short summaries/descriptions at the beginning of each subheading

Additional notes I'm happy to get involved in helping get this feature going, however, I have no clue where to start and haven't worked on this project before - so if anyone would be happy to walk through contributing with me/talking me through how to get this going, I'd love to learn!

NicBunn-PlutoFlume avatar Sep 14 '22 15:09 NicBunn-PlutoFlume

Can I work on this issue?

Sharanya98 avatar Oct 06 '22 15:10 Sharanya98

Hi there - just wanted to see if there was any update on this (or whether I could help anywhere!)?

NicBunn-PlutoFlume avatar Feb 02 '23 11:02 NicBunn-PlutoFlume

Any issue have help wanted label you can open PRs. We are welcome contributions. 🙌

AlexVarchuk avatar May 18 '23 16:05 AlexVarchuk

Can I work on this issue?

@Sharanya98 Did you ever start on this feature capability?

We would like to have our API descriptions in Redoc be displayed as url paths. Like this:

Image

However, when a user hovers over the url path, we would like to display something like this:

Image

nkoterba avatar Feb 13 '25 18:02 nkoterba