Thursday, October 2, 2008

Don't document more than that you have to ask to understand

Jeff Sutherland writes in his most recent blog entry about Agile Specifications. Interesting stuff!

I have rule of thumb that I use and try to teach everyone, when it comes to documentation: Don't document more than that you have to ask to understand. It is, I think, something to remember when it comes to writing agile specs, user stories, etc. Spending lots of time writing fancy specs and try to catch every little detail is just a waste of time, because I think it causes a false sense of trust in the spec. You won't succeed just because you discribe every little aspect of some feature. What will let you succeed is if the developers manage to understand it well enough to build it. And communication is key here. So don't write fancy specs just for the sake of it. Communicate instead! Ask! But as Jeff describes in his article above, of course you should document enough. We do write specs too (I'll describe our "scoping process" some day). But the above rule of thumb should always be kept in mind...

10 comments:

  1. COEPD LLC- Center of Excellence for Professional Development is the most trusted online training platform to global participants. We are primarily a community of Business Analysts who have taken the initiative to facilitate professionals of IT or Non IT background with the finest quality training. Our trainings are delivered through interactive mode with illustrative scenarios, activities and case studies to help learners start a successful career. We impart knowledge keeping in view of the challenging situations individuals will face in the real time, so that they can handle their job deliverables with at most confidence.

    https://www.coepd.us/certified-it-scrum-developer.php

    ReplyDelete
  2. Thanks for sharing this informative content , Great work
    Read this blog to know about : Definition of done

    ReplyDelete
  3. Thanks for sharing this.,
    Leanpitch provides online training in CSPO during this lockdown period everyone can use it wisely.
    Join Leanpitch 2 Days CSPO Certification Workshop in different cities.

    CSPO certification

    ReplyDelete
  4. Thanks for sharing this.,
    Leanpitch provides online training in Scrum Master Certifiation during this lockdown period everyone can use it wisely.
    Join Leanpitch 2 Days CSM Certification Workshop in different cities.

    Scrum master certification online

    CSM certification online

    ReplyDelete
  5. CSM online

    Thanks for sharing this.,
    Leanpitch provides online training in Scrum Master Certifiation during this lockdown period everyone can use it wisely.
    Join Leanpitch 2 Days CSM Certification Workshop in different cities.
    CSM online certification

    ReplyDelete
  6. It's really a important role in development of the software project on the real-time approach.

    We have Quickbooks solution for you to manage your account on single handed.
    Additional: if you facing any issue like Data Base Server Error jo clicked on the below link
    More Details:-
    Quickbook Database Server Error

    ReplyDelete
  7. Thank you for posting such a great article. Keep it up mate.

    Gati Shakti Yojana 2021

    ReplyDelete
  8. Technologistan is the popoular and most trustworthy resource for technology, telecom, business and auto news in Pakistan

    ReplyDelete
  9. Keep share your thoughts with us. It is well written article. I am really impressed. Now its time to avail twin falls taxi for more information.

    ReplyDelete
  10. Solid advice! 📝🤔 Keeping documentation concise but meaningful is key. What strategies do you use to strike that balance in your work? 🚀💡
    For best digital marketing company in noida Visit:- https://www.artattackk.com/

    ReplyDelete