Anselm R. Garbe wrote:
On Fri, Jun 16, 2006 at 09:45:02AM +0200, Steffen Liebergeld wrote:
  
You are right with that, but whenever I make somebody read you code I
get complaints about the missing documentation. So maybe you should at
least consider to document parts of it. The simple comments can savely
be left out, but *please* document what is not obvious.
    

It's hard to decide for a developer what's obvious and what not.
That's why it would be great to get a list of what is not
obvious once we are at a state in hg tip, when such feedback is
welcome (which might be around August).
  
    A very good place to start would be documentation as to what exactly each file is about.  What is an "area" for example?


-- 
[Geoff Washburn|[EMAIL PROTECTED]|http://www.cis.upenn.edu/~geoffw/]


_______________________________________________
[email protected] mailing list
http://wmii.de/cgi-bin/mailman/listinfo/wmii

Reply via email to