Redocly/redoc

Add tooltip functionality to Navigation Menu

开放

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

 (4 条评论) (0 个反应) (0 位负责人)TypeScript (2,272 个派生)batch import
Type: Enhancementhelp wanted

仓库指标

星标
 (21,877 个星标)
PR 合并指标
 (PR 指标待抓取)

描述

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!

贡献者指南