I would tend to agree, I would rather very much have the documentation revision controlled and stored with the source instead of a separate online site. I mentioned the online sites for the "online collaboration" you mentioned, which reminded me of "wiki" :).
Lyx, or other such tools would allow for this, since you'd just be editing files in the repo. Thanks, Rick Fleming On Fri, Oct 31, 2008 at 8:59 AM, Bill Barry <[EMAIL PROTECTED]> wrote: > I guess I wasn't clear at all about what I would rather: I'd very much want > to contribute patches to something stored in the repo and have the online > stuff generated than have to deal with making changes directly online. One > of the problems with doing the documentation online is that we would lose > the ability to reject changes and instead would need to undo them after the > fact. > > Richard Fleming wrote: > > A quick google search (online docbook editor) shows that there looks > to be projects around that combine "wiki style" websites with docbook > generators, which may provide an easy way to maintain docbook stored > documentation. I know there are some decent offline tools for docbook > also, I've used lyx which is a WYSIWYG editor for structured editing, > although editing the raw files might be clean as well. > > Keep in mind I haven't used any of these before, so I don't have > anything valuable to say about the projects found :). > > Thanks, > Rick Fleming > > > On Fri, Oct 31, 2008 at 8:28 AM, Bill Barry <[EMAIL PROTECTED]> wrote: > > > I am not very familiar with docbook docs (other than reading them), but > I really do like the output. Would it be written in the repo and the > sites generated or would it be some sort of collaborative online thing? > > Jonathon Rossi wrote: > > > While everyone is on the topic of change, do we want to move to the > docbook documentation that Symon Rottem set up a while back? It should > make it easier to write documentation. > > Do we really need multiple copies of the documentation hosted like we > have now? Because documentation tends to lag behind and is always > being updated after a release it might be better to have one copy like > jQuery has. > > MonoRail example of the docbook format: > http://www.symbiotic-development.com/monorail/html/index.html > > -- > Jonathon Rossi > > > > > > > > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Castle Project Development List" 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/castle-project-devel?hl=en -~----------~----~----~----~------~----~------~--~---
