On Jun 14 2013 7:48 PM, Matt Shaver wrote: > On Fri, 14 Jun 2013 09:40:06 -0600 > Sebastian Kuzminsky <[email protected]> wrote: > >> We have this (slightly out of date, and doesn't cover all the info >> Matt listed): >> >> >> http://www.linuxcnc.org/docs/2.5/html/code/Code_Notes.html#_architecture_overview > > This, but at multiple complexity levels. We need to add one to two > orders of magnitude to the detail level. A textual _Theory of > Operation_ for each operational block would help a lot too.
recently I was introduced to some advanced literate programming / test driven development tools. This was part of the advanced python tool chain, but I can see how they could be adapted to C/C++ (assuming that they have not already been done). One of the cool things with literate programming is that at least part of the documentation and regression tests can be co-located with the code. I will say that it can be overdone, but we might be able to leverage something. Jut a thought... EBo -- ------------------------------------------------------------------------------ This SF.net email is sponsored by Windows: Build for Windows Store. http://p.sf.net/sfu/windows-dev2dev _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers
