29 Jan
2007
29 Jan
'07
7:22 a.m.
Jeffrey Cunningham jeffrey@cunningham.net writes:
I wouldn't take much to put it back. But at this point I'm waiting to see some consensus from the community.
I think that a good index adds to the value of any piece of documentation, and I have to confess to being slightly baffled that there's an opposing view. If there were a way of automatically ensuring that the documentation matched the code, whether through automatic generation or automatic testing, that might make the maintainer's job easier, but that may not be practical.
Cheers,
Christophe