3 ms·
Serious question: What does TDD, BDD, Extreme Programming, SCRUM, Standups and all the stuff in the first paragraph have to do with writing a library or app wit
by bjclark 16y ago
Serious question: What does TDD, BDD, Extreme Programming, SCRUM, Standups and all the stuff in the first paragraph have to do with writing a library or app with proper documentation?
I'm completely lost as to how doing Extreme Programming means you don't have a good Readme for your Git-Powered wiki with sweet API?
- mcknz 16y agoNot necessarily anything -- it's only when Agile practitioners take "your documentation is your code" a bit too literally.
- mojombo 16y agoAll of those things are approaches to crafting better software. It is my observation that a lot of projects developed with these methodologies still lack proper documentation. And I see documentation, especially in the form of a good Readme, as critical to the design, usability, and longevity of a project.
- bjclark 16y agoDo you consider projects like http://erector.rubyforge.org/ http://erector.rubyforge.org/, http://pivotal.github.com/jasmine/user-guide.html http://pivotal.github.com/jasmine/user-guide.html, or http://github.com/pivotal/cedar http://github.com/pivotal/cedar to have good documentation?
- mojombo 16y agoSure. The documentation for those projects looks great!