Stefan Sperling wrote on Tue, Feb 22, 2011 at 15:10:57 +0100: > On Tue, Feb 22, 2011 at 03:32:24PM +0200, Daniel Shahaf wrote: > > Stefan Sperling wrote on Tue, Feb 22, 2011 at 10:27:24 +0100: > > > In particular note these two sections: > > > http://subversion.apache.org/docs/community-guide/general.html#code-to-read > > > http://subversion.apache.org/docs/community-guide/general.html#patches > > > I found those two very valuable when I started out contributing to > > > Subversion. > > > > > > > To be fair, #code-to-read has a mile-long list of header files, and I'm > > not sure that all of them are needed right away :) > > I did in fact spend a couple of days reading through them all before > I started writing any code. It did help a lot.
The doc comments, sure. But the text sounds like it says "Read every docstring in those files", which isn't a good idea... (and IMO isn't as useful as reading the relevant notes/ files, where they exist)