We have been thinking about this a fair bit. My thought is that asking for videos from development teams might just be too hard - teams don't comment/document enough often (or more accurately don't necessarily know what is worth documenting). So what if developers could easy get to architectural overviews and have an easy ability to save/share it, so that team members could comment on them and request for more such architectural descriptions.
Do you think that would meet similar needs? And have a collaborative atmosphere do help reinforce the need to build such 'documentation'? On a side note: While we have built the above for a couple of companies, we are trying to do something similar to Open Source projects as well. This site is not yet ready, but we would love to hear thoughts on this. See examples for the Lucene project: http://www.codemaps.org/s/Lucene_API and http://www.codemaps.org/s/Lucene_Core. (And if you are working on an open source project and want free licenses for such architectural documentation, feel free to drop me a note). Regards, Vineet -- Founder, Architexa - www.architexa.com Understand & Document Code In Seconds [email protected] :: 617.818.0548 On Tue, Feb 1, 2011 at 7:01 AM, Michael Easter <[email protected]> wrote: > > I am thinking more of a high-level architecture overview by the team > lead. IMO, a 1-hour whiteboard talk, done every 4-6 months, would be > of genuine value. > > It wouldn't help with specific corners of the code, but it would help > to understand the culture. > > In a comment, Alex Miller mentions that Terracotta records design > reviews (though they aren't viewed often) -- http://bit.ly/eoN1R4 > > On Feb 1, 4:55 am, "Vince O'Sullivan" <[email protected]> wrote: > > On Feb 1, 2:20 am, Michael Easter <[email protected]> wrote: > > > > > My question: why not use video? > > > > If you can't get people to comment their code, I doubt you'll get them > > to video it. > > -- > You received this message because you are subscribed to the Google Groups > "The Java Posse" group. > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]<javaposse%[email protected]> > . > For more options, visit this group at > http://groups.google.com/group/javaposse?hl=en. > > -- You received this message because you are subscribed to the Google Groups "The Java Posse" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/javaposse?hl=en.
