You're on your way to the next level! Join the Kudos program to earn points and save your progress.
Level 1: Seed
25 / 150 points
1 badge earned
Challenges come and go, but your rewards stay with you. Do more to earn more!
What goes around comes around! Share the love by gifting kudos to your peers.
Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!
Join now to unlock these features and more
In the components section of a Statuspage's generated documentation, the description of Components enumerates possible component statuses as:
"Each component is listed along with its status - one of operational, degraded_performance, partial_outage, or major_outage."
The component status "under_maintenance" has been omitted from this description, which is confusing. As an engineer, when I read the phrasing "- one of ..." my expectation is that a complete list follows, not a partial list.
Suggestions on how to improve this might be:
- add the "under_maintenance" value to complete the cited description, or
- remove the incomplete description, and just link to the relevant API docs instead, or
- change the wording from "one of" to "for example"