Small updates to REST API docs styleguide

* Linter was failing with previously recommended status code path.
* There was no mention of adding new pages to Global Navigation.
* Learned via putting together https://gitlab.com/gitlab-org/gitlab/-/merge_requests/111087