Developers often add documentation to microflows in the form of an annotation, because that's clearly visible. But there's also the "Documentation" property that nobody uses yet. I think we should document using this property, because the content of this property is exported to the generated html documentation of the app. The only thing we need to start using this is that this documentation should be shown much more explicitly on the canvas.
I can concur. I have a team member who is wonderful at adding annotations to every flow, but I find it frustrating because now I have to copy all of the notes into the documentation too, and they will 100% go out of date when anything changes.