>>>>> On Mon, 24 May 2010 18:01:49 -0400, Doug Manley <doug.man...@gmail.com> 
>>>>> said:

DM> Thank you for your time in responding to my question; at our company,
DM> we believe in heavily documenting all code before it can be accepted
DM> (if that means that people need to work late to get it in, they do
DM> ^_^).  One of the things that we've found is that what is easy and
DM> obvious today is crazy and esoteric tomorrow (especially when it's
DM> someone else reading the code).

One of the fundamental differences between a company and an open source
project is that you can't "mandate" things.  The best you can do is "not
accept the patch unless it's documented".  Unfortunately, in this
project it seems that would almost always fall down to "not accept the
patch".  Commercial companies tend to like to throw us code randomly
over their wall but really don't care that it's not documented nor do
they care if we accept it much.  We end up taking many scraps from
companies because the feature is good and worth-while, even if
un-or-poorly-documented.

I'm actually in the middle of adding lots of comments to a part of the
library that has been before-this largely undocumented.  We do what we
can when we can.

DM> I don't mean to criticize anyone in particular; I was hoping that we
DM> could collectively make a push for a more coder-friendly source code
DM> that newbies can read.

I actually think that you'll only find violent agreement here.  Everyone
I know that has a desire to spend copious amounts of time on the project
for the benefit of it (most notably Dave who has likely spent more than
anyone else) agrees that both comments and documentation are extremely
important.

It's making them exist that has traditionally been difficult.

(there is, of course, a fine line as was pointed out by someone else...
  i++; /* increment i by 1 */ 
 is beyond necessary; every situation has two extremes at least to be avoided)
-- 
Wes Hardaker
Please mail all replies to net-snmp-coders@lists.sourceforge.net

------------------------------------------------------------------------------

_______________________________________________
Net-snmp-coders mailing list
Net-snmp-coders@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/net-snmp-coders

Reply via email to