Let’s talk about usability in https://docs.github.com/en/rest/reference the REST API new home
The usability is IMHO a nightmare.
- API Response specs are an essential part of API doc and are hidden by default, need to click for folding out.
- Browser search does not find anything in API response specs, unless I click and open the respective part.
Steps to reproduce:
- Go to https://docs.github.com/en/rest/reference/users
- Use browser search to find term “avatar_url”
- No result
- Click to open “default response” on any of the API sections
- Retry search
- Find expected results