document diagram fixes