How do you balance documentation requirements with Agile developments
        Posted  
        
            by 
                Jeremy
            
        on Programmers
        
        See other posts from Programmers
        
            or by Jeremy
        
        
        
        Published on 2011-03-06T00:40:29Z
        Indexed on 
            2011/03/06
            16:18 UTC
        
        
        Read the original article
        Hit count: 442
        
documentation
|agile
In our development group there is currently discussions around agile and waterfal methodology. No-one has any practical experience with agile, but we are doing some reading.
The agile manifesto lists 4 values:
- Individuals and interactions over processes and tools
 - Working software over comprehensive documentation
 - Customer collaboration over contract negotiation
 - Responding to change over following a plan
 
We are an internal development group developing applications for the consumption of other units in our enterprise. A team of 10 developers builds and releases multiple projects simultanously, typically with 1 - maybe 2 (rarely) developer on each project.
It seems to be that from a supportability perspective the organization needs to put some real value on documentation - as without it, there are serious risks with resourcing changes.
With agile favouring interactions, and software deliverables over processes and documentation, how do you balance that with the requirements of supportable systems and maintaining knowledge and understanding of how those systems work?
With a waterfall approach which favours documentation (requirements before design, design specs before construction) it is easy to build a process that meets some of the organizational requirements - how do we do this with an agile approach?
© Programmers or respective owner