The savepoint docs are very detailed and focus on the internals. They should better convey what users have to take care of.
The following questions should be answered:
What happens if I add a new operator that requires state to my flow?
What happens if I delete an operator that has state to my flow?
What happens if I reorder stateful operators in my flow?
What happens if I add or delete or reorder operators that have no state in my flow?
Should I apply .uid to all operators in my flow?
Should I apply .uid to only the operators that have state?