Docs: Improve API resources lists
On our main API pages https://docs.gitlab.com/ee/api/ https://docs.gitlab.com/ce/api/, we have a list of Resources, linking out to their doc pages. They use 'friendly names' which are not quite in alphabetical order, and even when they are, the order often isn't helpful. For example, we have "Group Access Requests" and "Project Access Requests" yet the resource itself is access_requests. Originally reported by @rspeicher.
MVC: Any and all improvements to this page.
Additional proposal:
Perhaps a sortable table is the way to go, with headers:
Resource | Group | Project | Instance
(With doc icons under Group/Project/Instance as appropriate, linking to the docs.)
So you could have a resource-based view, showing you the equivalent of
/access_requests (group, project)
And in another view, you'd be able to understand all resources available at the scope level (project, group, or instance), equivalent to
/projects
/access_requests
/etc
New doc or update?
-
New documentation -
Update existing documentation