Forums for the Business Analyst

 
  Modern Analyst Forums  Business and Sy...  Requirements  Do you maintain "live" documentation?
Previous Previous
 
Next Next
New Post 1/8/2008 10:01 AM
Poll
User is offline Adrian M.
764 posts
3rd Level Poster




Do you maintain "live" documentation? 

A recent thread started by Perry (see: here), who's working on defining the process and guidelines for his current employer, got met thinking again about "live" specs.

The agile camp tends to favor less documentation in favor of well commented code while the more traditional camp favors detailed documentation upfront.  For those of you, who create detailed documentation, say for a brand new system: do you plan to maintain that documentation?

Do you maintain "live" specs? 

- Adrian 


Adrian Marchis
Business Analyst Community Blog - Post your thoughts!
 
New Post 1/9/2008 11:55 AM
User is offline Adrian M.
764 posts
3rd Level Poster




Re: Do you maintain "live" documentation? 

FYI: This thread is marked as a Poll Thread. Logged-in users can participate in the poll and view the results.

- Adrian


Adrian Marchis
Business Analyst Community Blog - Post your thoughts!
 
New Post 1/10/2008 9:21 PM
User is offline Craig Brown
560 posts
www.betterprojects.net
4th Level Poster




Re: Do you maintain "live" documentation? 

Adrian

A friend of mine just ran an agile project and they used a bunch of whiteboards as their requirements and spcecification repository.  They were kept fairly up to date.  Especially his personal list of "things the buisiness has forgotton about but we need to deal with."

 
New Post 1/11/2008 5:49 AM
User is offline Achyut Dhakal
1 posts
No Ranking


Re: Do you maintain "live" documentation? 

My experience is that it totally depends on the complexity of the sytem under development. If it is small to mid sized projects, the process tends to be Agile. But, for complex systems and involves multiple cross-functional teams, it makes work a lot easier to have all the documents live and updated.

Thanks,

Achyut Dhakal

 
New Post 1/11/2008 8:33 AM
User is offline Adrian M.
764 posts
3rd Level Poster




Re: Do you maintain "live" documentation? 

 craigwbrown wrote

Adrian

A friend of mine just ran an agile project and they used a bunch of whiteboards as their requirements and spcecification repository.  They were kept fairly up to date.  Especially his personal list of "things the buisiness has forgotton about but we need to deal with."

Hi Craig,

That's very interesting...  I wonder how long those white boards are going to stay up as compared to how long the system is supposed to be in use.  What's going to happen when the cleaning staff decides to be helpful and clean up the boards?  My definition of keeping the documents "live" was to keep them up to date as long as the system is in use.

- Adrian


Adrian Marchis
Business Analyst Community Blog - Post your thoughts!
 
Previous Previous
 
Next Next
  Modern Analyst Forums  Business and Sy...  Requirements  Do you maintain "live" documentation?

Community Blog - Latest Posts

Fabricio Laguna talks Business Analysis and AI
I recently connected with Fabricio Laguna, aka The Brazilian BA. Fabricio is a passionate and pioneering business analyst from Brazil. During our conversation, we had a thought-provoking discussion on how artificial intelligence stands to shape the field of business analysis in the years ahead. While AI promises to transform many aspects of busines...
Business Architecture, Ontology and More with Terry Roach
It's been a privilege meeting Terry Roach, a visionary in the field of enterprise architecture and business architecture. Terry's insights into the evolution of business models, the importance of ontology in architecture, and the potential of AI to shape our future were not only thought-provoking but also a reflection of his extensive exper...
Today I had the pleasure of chatting to Jignesh Jamnadas, Chief Operations Officer at Mosaic, about his Blueprints for Success. As a Senior Finance and Operations Executive, Jigs (as he is known to many) has a holistic understanding of all facets of business and a flair for managing both people and processes. Having worked with Jigs, I was struc...

 



Upcoming Live Webinars




 

Copyright 2006-2024 by Modern Analyst Media LLC