"Serguei Mokhov" <sa_mokho@alcor.concordia.ca> writes:
> And what's wrong in automated guide generation?
Even more to the point, what's wrong with looking at the source code?
(Why would you want a "line by line" guide if you're not looking at the
source code, anyway?)
We could probably do with more extensive high-level documentation than
we have, to point people to the parts of the code that they need to read
for a particular purpose. But I agree with Sergei that it's hopeless
to try to divorce low-level documentation from the code itself.
One thing that I find absolutely essential for dealing with any large
project is a full-text indexer (I use Glimpse, but I think there are
others out there). Being able to quickly look at every use of a
particular identifier goes a long way towards answering questions.
regards, tom lane