[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: succinctness = power
> Documentation generators, like javadoc are useful, but sometimes
> documentation takes on a life of its own. I once looked at the 73
> uses of EventListenerList and found 25 cases where the documentation
> did not match the code.
My experience with comments is similar. They lie. They were probably
right when they were written, but there is no mechanism to enforce
keeping them in sync with the code.