Oral Documentation

by javery on June 11, 2004

“I go looking for function X amongst the code. I can’t find it. In fact, I started looking for it sometime yesterday, and haven’t found it yet. I check the folder marked “docs“, to find it contains only a single README.txt file, the sole contents of which is the teaser “This directory will contain the docs” – apparently the dying message of a long extinct group of developers whose brains exploded before being able to make good on their promise.”


- Oral Documentation – Not Worth the Paper It’s Written On  


When agile development goes bad. (It was not really Agile anyway, but people tend to take little parts and create their own frankenstein methodology (and just like in the story it becomes the death of them and their project))


Oh, and on a similiar note Darrell is peeved about people abusing the agile name.


-James

{ 3 comments }

Darrell June 11, 2004 at 12:17 pm

> and just like in the story it becomes the death of them and their project <

And then they need something to blame it on, so they blame it on process because that’s the current thing. In a few years everyone will blame the technology again, or maybe the management. :)

Darelict June 16, 2004 at 8:26 pm

he… he… you said Oral.

Hmm June 18, 2004 at 3:18 pm

" (It was not really Agile anyway, but people tend to take little parts and create their own frankenstein methodology "

Funny, because I keep hearing Agile proponents talk about only using the parts of Agile that work for you. "It’s not cumbersome", they say, "It’s Agile because you only need to use what the parts that you need."

..and then when the whole thing fails they say "Oh, well you only used part of Agile. No wonder it failed."

Comments on this entry are closed.

Previous post: Poynter Online – The Blog-Only News Diet

Next post: Political Blog