On 1/28/07, Christophe Rhodes csr21@cantab.net wrote:
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.
I've listed the reasons why I'm opposed to the index in these posts: http://common-lisp.net/pipermail/slime-devel/2007-January/005803.html http://common-lisp.net/pipermail/slime-devel/2007-January/005869.html http://common-lisp.net/pipermail/slime-devel/2007-January/005872.html
You can disagree with me, but I don't think you need to be baffled. ;-)
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.
-- Bill Clementson