Redocly/redoc

Add tooltip functionality to Navigation Menu

Open

#2,165 创建于 2022年9月14日

在 GitHub 查看
 (4 评论) (0 反应) (0 负责人)TypeScript (21,877 star) (2,272 fork)batch import
Type: Enhancementhelp wanted

描述

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!

贡献者指南