I am struggling trying to figure out how to use the location manager api in sipxconfig. I'm am a firm believer in self documenting code, but after the code has been simplified as much as possible, adding comments makes a lot of sense. I'm as guilty as anyone else for not documenting, but I now have a renewed sense.
So I'm not necessarily looking for "yeah, i agree, we should make an effort to document our code more" because i suspect we'd all have the comment. I'm more looking for : * war stories from people about how they suffered learning the code because of the lack of comments * notes from folks they had the same ideas as me, but just didn't bring it up * comments that you disagree * ideas on how to motivate developers to comment their code. If if get enough positive feedback, one idea i had was to publish the javadocs to sipfoundry on an automated basis so we have a canonical location to reference. _______________________________________________ sipx-dev mailing list [email protected] List Archive: http://list.sipfoundry.org/archive/sipx-dev/
