I find it useful to document my flows using a Script connector as follows:
I’ll just add that in the latest releases of CData Arc, we’ve also added a feature that will let you promote whatever value you place in the Connector description as a tooltip that you see from the Flows view:
