WRT video documentation - I have tried a trick that I think I learned from one of Alistair Cockburn's books.
Give an hour-long talk on the topic (architecture, design, whatever) to several of your target audience (other devs, customers etc) and record it. Then have a Q&A session with the audience, also videoed. This way your talk will be addressed to real people, and anything that you miss and isn't obvious should be covered in questions afterwards. I've only done this once - as the handover for a project that was being mothballed, but it seemed to work well. Duncan -- You received this message because you are subscribed to the Google Groups "The Java Posse" group. To post to this group, send email to javaposse@googlegroups.com. To unsubscribe from this group, send email to javaposse+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/javaposse?hl=en.