[webkit-dev] Class-level comments in the source code

Per Bothner per.bothner at oracle.com
Fri Jul 6 14:37:20 PDT 2012

On 07/06/2012 02:02 PM, Maciej Stachowiak wrote:

[... reasonable stuff I fully agree with - but one question ...]

> Documenting ownership and lifetime relationships is also useful. We have tended to do that as diagrams separate from the code, since the places where it is most needed tend to be complicated clusters of related objects.

Wouldn't such diagrams be harder to keep up-to-date than comments?
	--Per Bothner
per.bothner at oracle.com   per at bothner.com   http://per.bothner.com/

More information about the webkit-dev mailing list