Follow-up from "Update API Descriptions"

The following discussion from !207716 (merged) should be addressed:

• @hfyngvason started a discussion:

  Related to !207716 (comment 2804354265), should we have a linter for these? We already have vale in our tooling, running it over the openapi file should be pretty easy. Starting a thread so I can resolve in a follow-up.