[OGo-Documentation] user documentation & rpm

[Chris H]

David Nalley wrote:

>Chris, 
>
>I _can_ take ownership of it. However, we've also talked about doxygen. I don't think my schedule would permit me to do both and keep up with both if the manual is going to changing alot. In short, let me know which is the most important, and I can work on it. 
>
Yes I know. The doxygen stuff seems to not have gotten a response from 
Helge other then info overload, which is correct. What I gather from 
that is that source documentation is important but its also a function 
of how that source is bundled. Since there is little communication on 
this issue at present I would say that its not a priority at this time. 
Helge if your listening???
I can address this issue on an as needed basis as long as there are 
others on the lists who can review the output. Code documentation simply 
is ancient hebrew to me, something that I have not mastered..:)

The user documentation IMHO should be the priority at this time.

What I meant by owning the work, is simply this. The user manual in 
theory is a live document. It will require a periodic release based on a 
yet to be determined incremental release schedule. The conversion of the 
document into docbook and associated output formats is a process that 
will be ongoing over time, so if we decide to use this mechansim, then 
there is a need to consider some form of long term commitment or skill 
transfer via howto for lesser mortals, which is probably the best way to 
go. Thoughts??

/ch