I know that. And I'd like to read code. Developers written great code and also plenty of comments(which is documentation) in code. However, there are sth. don't need to comment in code but should be available on wiki. E.g. I followed the svn commit log, and found sip_auth_username and sip_auth_password added, so I documented to the wiki.
On Apr 1, 2009, at 6:00 PM, Jason White wrote: > seven <[email protected]> wrote: >> Agree, I think the author better to document the code first. > > Well, actually... it's already done. It's called API documentation, > and > consists of specially written comments in the code. > > This is not user-level documentation, however; it exists to help > programmers > who want to write applications or FreeSWITCH modules, or to > participate in the > development effort. > > Keep in mind also that this is a free software/open-source project; > the > developers are free to decide how best to spend their time. I agree with you, whether of not document to wiki is up to the developers. But I just think it would be better(or more easier) if we(or others) can find all (including all the newest) params or features in wiki so we can try it and add document more on wiki. > > > Personally, I would rather that they spend as much of the time as > they wish > writing and maintaining code. > > I've read enough of the code in FreeSWITCH to appreciate its high > quality and > the soundness of the design. > > It should also be remembered that the source code is the ultimate > documentation, and everyone is free to look at it and to document > (in their > preferred natural language) what they find out. > > So do I. I'd like following the svn commit log to see what's new in there. But not all of us like to or have the time to read source code. Perhaps that's why we are here to help documenting.... > _______________________________________________ > Freeswitch-users mailing list > [email protected] > http://lists.freeswitch.org/mailman/listinfo/freeswitch-users > UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-users > http://www.freeswitch.org _______________________________________________ Freeswitch-users mailing list [email protected] http://lists.freeswitch.org/mailman/listinfo/freeswitch-users UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-users http://www.freeswitch.org
