I would find this enormously helpful.  I also think there&#39;s less risk of it going out of date (compared to most documentation) since the connections between objects and their null characteristics are _very_ entrenched.<div>

<br></div><div>J<br><br><div class="gmail_quote">On Tue, Aug 11, 2009 at 3:03 PM, Adam Barth <span dir="ltr">&lt;<a href="mailto:abarth@webkit.org">abarth@webkit.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">

In reviewing patches, I feel like I&#39;m commonly pointing out<br>
DOMWindow::frame and Document::frame, etc, can be null in some<br>
circumstances.  Would it be useful to have a diagram of the major<br>
objects (Page, Frame, DOMWindow, Document, etc) somewhere on<br>
<a href="http://webkit.org" target="_blank">webkit.org</a> that shows their relation, which links can be null, and<br>
which objects change / are preserved during navigation?<br>
<br>
If so, I&#39;m happy to create this with my current knowledge, and<br>
hopefully folks with more experience will add parts that I don&#39;t know.<br>
 What&#39;s the best medium to make this easy to update in the future?<br>
SVG?  ASCII art?<br>
<br>
Adam<br>
_______________________________________________<br>
webkit-dev mailing list<br>
<a href="mailto:webkit-dev@lists.webkit.org">webkit-dev@lists.webkit.org</a><br>
<a href="http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev" target="_blank">http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev</a><br>
</blockquote></div><br></div>