2024-10-11 Scheduler clarity and API work
⚙️ API fixes and updates
Our API documentation has been updated to cover questions we've received, and we've shipped a few bug fixes to make things more resilient.
- Moment and Page received doc updates, as did other places in the documentation that reference them.
- Calls to moment creation are now more resilient.
- We've improved some diagnostics to help debug when things go awry.
- Immediate expiration of API keys now works correctly.
🗓️ Scheduler improvements
Hotpot's innovative scheduler is rad, and we continue to find interesting use cases and tuning opportunities. We will keep some exciting under-the-hood work for an upcoming major feature to ourselves, but we can discuss these!
- If there is a gap in the schedule, the scheduler will now fill that gap instead of only considering the furthest out stint.
- Unavailability that spans an entire month is no longer shy; it shows up when viewing the spanned month.
- We are shuffling the set people now before picking who will be on-call. This fixes some narrow cases where the scheduler seemed to pick people consecutively but was just insufficiently randomized.
- We updated our documentation to help understand the benefits and outcomes of the scheduler.
- Updated the helper text when entering unavailability to be less clever.
🩺 Stint problem clarity
A stint with missing assignments will not occur until someone completes the assignment. To make this clearer, we now render the assignments in gray.

Randal won't actually be placed on-call until that pending assignment is complete.
If an unresolved stint is never fixed, Hotpot will place the schedule's backstop on-call as an emergency adjustment. We now plead to you to fix this in the UI a week before it happens, just in case!

Fix this or Kirsten is going to be on-call!
🕵️♀️ Triaging moments
Categorizing moments during triage is powerful, and we're getting lots of amazing feedback as customer leverage moment groups for their internal needs. We're doing a lot of work here, stay tuned!
Additionally, we've relaxed the restrictions on moving moments between stints. Sometimes, moving a moment into the previous or next stint makes sense. This is now possible!
Lastly, the icon and color of a group is now consistent between single and batch operations.
💼 Other changes
- General: Coverage-related messages no longer cause issues when shown in the message listing.
- Settings: Errors during password changes now correctly remember where they live in navigation.
- UI: Some icons changed. We won't tell you which ones, though. See if you can find them!
- UI: We found and eliminated more typos and grammar problems.
- UI: Hey, it's nearly Halloween. Dark mode has more fixes! 👻
- UI: The Prometheus integration now has a proper icon, and we fixed some weirdness in its docs. Yay!