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

[Per Bothner]

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/