[ET Trac] [Einstein Toolkit] #122: Code documentation

Einstein Toolkit trac-noreply at einsteintoolkit.org
Mon Nov 29 09:56:35 CST 2010


#122: Code documentation
-------------------------+--------------------------------------------------
 Reporter:  hinder       |       Owner:  mthomas
     Type:  enhancement  |      Status:  new    
 Priority:  minor        |   Milestone:         
Component:  SimFactory   |     Version:         
 Keywords:               |  
-------------------------+--------------------------------------------------
 In order to help new developers understand the code, the following would
 be useful:

 * Provide some sort of high-level overview of the internal components of
 simfactory.  This could be in the form of a class diagram with annotations
 indicating what each class does, and its relationship to the other classes
 (inheritence/object membership etc).  There must be tools for doing this
 for python and generating doxygen-type output.

 * Within the source code, provide at least a one-line comment for each
 function indicating what it does.

 * Ensure that the readmes etc in the repository are up-to-date, or at
 least remove any out-of-date information.

-- 
Ticket URL: <https://trac.einsteintoolkit.org/ticket/122>
Einstein Toolkit <http://einsteintoolkit.org>
The Einstein Toolkit


More information about the Trac mailing list