docs icon indicating copy to clipboard operation
docs copied to clipboard

Improve location of FAQ, Troubleshooting Guides, Dev Resources and Contribution Guidelines in side nav

Open elenananana opened this issue 2 years ago • 1 comments

Currently FAQ, Troubleshooting Guides, Dev Resources and Contribution Guidelines are all sections that are repeated under each product.

Recommendation is to move all these sections into their own pages (such as all FAQs in one section, listed out by product vs a separate FAQ page per product). Other ideas mentioned by the team

  • Great idea, intuitively I (and I think Devs) Look for Products and then questions within those products. We could have a generic FAQ section for areas that are broader.
  • combining Troubleshooting guides in the sidebar with this FAQ page
  • same with “Developer Resources” under each product, links to blog, youtube, and discord. Feels repetitive when those links are easily discoverable.

elenananana avatar Oct 05 '23 21:10 elenananana

this can be a part of the structural redesign, something resembling a layout like this Screenshot 2023-10-31 at 3 55 25 PM

ryanwaits avatar Oct 31 '23 20:10 ryanwaits

closing: close duplicate to https://github.com/hirosystems/docs/issues/506

ryanwaits avatar Jun 30 '24 16:06 ryanwaits