Experimental Physics and
Industrial Control System

Andrew Johnson <[email protected]> · Tue, 15 Mar 2011 10:45:21 -0600

On Tuesday 15 March 2011 11:20:44 Jeff Hill wrote:
> The downside maybe is that every manual reads like a
> reference manual, and we are less likely to have a tutorial. We are maybe
> more likely to create human friendly documentation with concept structured
> indexes and html tables if the html is structured by a human?

There are at least two different kinds of programmer documentation; doxygen is 
designed for writing API reference manuals, but not for the other kinds.  Both 
are usually needed, but programmers (myself included) often try to avoid 
writing the other kinds.

Please take a look at Michael's new source layout branch (even write some 
review comments?) before deciding on a new layout.

- Andrew
-- 
An error is only a mistake if you don't learn from it.
When you learn something from it, it becomes a lesson.

Experimental Physics and Industrial Control System

Experimental Physics and
Industrial Control System