documentation now includes a flowchart of balrog's data flow