I find that sequence diagrams can be really helpful when documenting systems. Here's a nifty web UI for creating them: https://sequencediagram.org/