Feedback

Nothing worse than taking the time to type up a bunch of feedback only to realize the submit ideas forms is broken, so dropping it here instead:

(nice to have) Support for content snippets so content blocks can be reused in multiple places. These are similar to the variables but for lengthier content.
(critical) Add a self-help troubleshooting/FAQ section without the ability to comment. Or just disable the ability to comment on the discussions tab. The discussion tab is actually somewhat well suited for this except it doesn't have a more prominent search bar and we don't want to allow for discussions because we don't have the manpower to keep up with that. Users will use it for support tickets and we won't be able to answer and stay on top of that.
(important) Add a notifications/announcement page/feed. This is great for seeing upcoming API changes before they happen, broadcast planned changes, mention planned downtime, etc. This would be different than just having a custom page in that it can show an unread notification symbol and re-appear when there's a new message (based on user or if not logged in use local storage).
(critical) Within Metrics, I don't just want to see the 400/500 errors. I want to see all calls (200 status codes included). The reason this is important is because the quantity of errors is useless in itself if you don't have the context of the amount of total calls are being made. For example one week endpoint /abcxyz may have 100 calls with 10 returning 400 and the next week there can be 50 calls and again 10 returning 400 errors. The error rate doubled but without the context of the calls made you wouldn't be able to tell. This is important to know for improving the docs.
(important) Add the ability to pre-populate parameter inputs WITHOUT needing to use defaults.
(critical) When you click the "Try It" button, DO NOT clear the parameter values. This has been a pain point for our users. Honestly surprised this hasn't been done yet. With this you'd also want to add a "clear values" button.
(important) The landing page could use better, more modern standard components similar to what is used here: https://docs.opensea.io/