Taking inspiration how you work with Jupyter notebooks and use the notebook to show your workings, wouldn't it be great if you could document your workflows directly on the canvas more in a notebook style.
I think this essentially can be summarised down into two features:
1) Markdown functionality in the comment tool
2) Ability to import results from IRG and / or browse tool directly into the canvas.
I have mocked up a version of what this could look like in the screenshot below.
Overall I think it would improve the experience of documenting workflows as you can show your workings in-line while building the workflow. Plus it solves the debate around team vertical vs team horizontal as you build using both!