On Jul 6, 2009, at 8:09 PM, Иван Бессарабов wrote:

>
> How are you generating docs automaticly?

These are for docs that are intended to be user docs. Various programs  
can generate their options, build info (things like svn info) and the  
like. A script generates all the pages. I use trac-admin to read them  
all in. These are often [[Include]] in user-maintained docs that  
expand on the information. One nice thing about importing wiki pages  
from a directory into trac is that trac tells which have changed.  
Which is where [[RecentChnages]] fits in. We just look at the changes  
and it reminds us where to update the docs. The thing is, there are  
hundreds of these pages. So, a hierarchy helps keep order, and makes  
naming/grouping much easier. Thus my question.

For program docs, we have been fiddling with Natural Docs. It does a  
pretty good job at generating docs and cross references. We have not  
taken the plunge yet. I do not know if these docs would need to be in  
a trac wiki, as Natural Docs makes full systems of pages. Of course,  
if it made trac wiki pages, we would have a nice consistent look and  
feel.

--
Roger Oberholtzer
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "Trac 
Users" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to 
[email protected]
For more options, visit this group at 
http://groups.google.com/group/trac-users?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to