News for hackers. Stuff that matters.
Re:Scrum is the new waterfall by rbanffy on Tuesday November 10, 2015 @07:28PM (#10543827)
>> If your software is working, but there is no documentation

> This is not a prerequisite of agile development.

What I often see in "waterfail" projects is documentation that's inaccurate and reflects what once was the plan someone wanted to build.

Re:Scrum is the new waterfall by Joof on Tuesday November 10, 2015 @08:30PM (#10544186)
As an aside; I've been playing with rust and it's built-in documentation solution has an interesting quality to it. Code snippets in documentation are compiled and can be tested at compile time.

It's one excellent way to ensure that updates that necessitate a change in documentation actually get documented.

Re:Scrum is the new waterfall by rbanffy on Tuesday November 10, 2015 @08:31PM (#10544194)
I love using doctests in my Python code. They can't replace proper tests, but its great to be able to guarantee your docstrings are correct.
Re:Scrum is the new waterfall by matthewmacleod on Tuesday November 10, 2015 @08:00PM (#10544004)
This is so often the case, I agree. I can't count the number of times I've received a design document that details to the level of database field names – and of course, never bears any relation to the final product.