How do you document specific sections of a VI?

Question

Once in a while I'll use a VI (perhaps one of mine or one from vi.lib) to do something in an unusual way.  How would you document this usage so that when you go back to it some weeks later you don't have to scratch your head wondering why you did it that way?  A free label near that VI (or wire) clutters the diagram and gets lost when doing a diagram cleanup (ctrl-U).
I can think of a couple of ways that NI could help us out.  One would be to allow me to attach a documentation property to an instance of a VI or wire.  This documentation would show up as either a tool tip when you hover the mouse over the object, or in the Context Help window.  An indicator would be needed on the VI or wire to let me know that there is documentation available.  The indicator may be something that resembles a coersion dot though in a different location so it won't be confused as a coersion dot.
On a related note, I've seen a few diagrams that have transparent labels on top of a wire indicating what that wire does.  This is a pretty good kludge to document a wire.  Perhaps a label property can be attached to the wire in much the same way as the documentation property I describe above.  The label would be visible and automatically displayed on top of the wire.  The key difference is that the label would be owned by the wire and could not get misplaced.
 - les

Answer 1

I like the way NI documents code in some of their examples.  They use small labels with a number or letter in it.  Then below is a huge label with explanations of each numer of letter.  See the picture:
Message Edited by tbob on 09-23-2008 12:27 PM
- tbob
Inventor of the WORM Global
Attachments:
Dynamic Generation and Acquisition-Source Synchronous_BD.png ‏18 KB