When documenting something that you programmed and required a decision, it is often useful to also explain the paths not taken. Options you considered but rejected in favour of the current implementation. It can help a lot with understanding what the implementation is trying to achieve, what problems it solves that certain alternative might nog solve (or not solve as well).