Hi HN, I struggle documenting complex distributed algorithms. Sequence diagrams are great for precision, but you end up with the prose on one page, explaining each step, and the reference diagram elsewhere, which is really hard to read. The readers eyes have to go back and forth long distances.

This notebook is my revelation of using interaction to limit the prose and to highlight the active step on a sequence diagram. This seems to aid in readability for me a lot.