• I would tend to use JavaDoc for all my Java documentation, not just external APIs -- HilaryHolz

This will get more organized, but for the moment, I'm just stashing things here...

• A good first place to look is the homepage of the Agile Alliance
• Agile is closely related to the Open source movement. The essays in Open Sources: Voices from the Open Source Revolution can help you understand where agile came from and how the founders view the issues.
• I like this set of materials about Scenario-based design from gmiller at Stanford because it shows a variety of different kinds of scenarios.

Here's an example of the evolution of agile methods 'in the wild' - how it grew and shaped the development of a major wiki platform, TWiki (amusingly, the platform we are using to show you this page). I came across it in my professional work, and wanted to show it to you.

To see the process happening, follow the issue over time:

1. You can see the interaction between the core developers and plugin and skin developers happening here. Skin developers are pretty 'core', too, so their concerns are really important. An example of skin development is on PatternSkinDev, where you can see a lot of the design discussion, as well.
2. The discussion on SkinsAndJavaScript led to a refactoring of the full javascript model in TWiki, and led to other methodological changes. The refactoring change currently has a suggestion and a request for a test. Notice that the person who suggested the change did not realize that they were only being asked for the test (test-driven development), but thinks that they have to provide both code and test...
   • TWikiJavaScriptRefactoring
3. here's the resulting lovely agile structure, with a testing framework and the whole nine yards...
   • JavaScriptCodingStandards

You may also find their whole structure interesting, especially:

• SoYouWantToBeATWikiDeveloper
• DeveloperResponsibilities
• Perl_coding_standards
• CssCodingStandards
• and, of course, the above JavaScriptCodingStandards

-- HilaryHolz - 07 May 2008