On Mon, Feb 07, 2005 at 09:24:57AM -0500, Daniel Thor Kristjansson wrote: > On Sun, 6 Feb 2005, Nav Jagpal wrote: > ]Is there a need for any type of documentation, manuals, etc? > > There is a need for developer documentation. Starting with a guide to > theming and a guide to producing a debug build and a backtrace for bug > reporting. But we also need an overview of the classes and how they > interact and something like doxygen for the code itself.
When I started looking at the code I would have loved to have seen docs on the scheduler, on the frontend protocol. Also, significant sections of the code are uncommented beyond having descriptive symbol names -- so adding comments to variable names and function names would be an important part of documenting the classes. As for user docs, one start is reading mythtv-users mailing list and seeing what things people are asking the most questions about. In some cases it is undocumented stuff, in other cases it is documented but they are not finding the documentation. In the latter case, it's a challenge to reorganize those docs so that even an idiot can find the answer to their question. There are also many levels of users, and as Mythtv grows in popularity, you will see more users who need to be walked through things, folks who are less linux-familiar etc.
_______________________________________________ mythtv-dev mailing list [email protected] http://mythtv.org/cgi-bin/mailman/listinfo/mythtv-dev
