Re: Need Clarification
Chris Dudley <[email protected]> Tue, 05 Apr 2005 13:36:57 +0100
| Newsgroups | gmane.comp.cms.xaraya.documentation |
|---|---|
| Organization | Xaraya |
| Message-ID | <[email protected]> |
stratagem wrote: > So we put a lot of effort into documentation that may or may not be > available as anything but articles on xaraya.com? > > I had thought we went about this from the repository side in the same > manner as the RFC's. > > I just don't understand why the source of these docs are simply articles > that are staged in the waiting content areas as submitted articles for > editing. There is no real way of doing any kind of version control, etc. > > Please enlighten me. > They are articles on the site for easy editing and collaborative working. Much as I would like everyone to be using docbook and bitkeeper it was never going to work - so we use the model that works best for the task at hand. Revision control of the content is handled by the changelog module. The workflow module can also be used. TinyMCE can be used for WYSIWYG editing if you like. They are submitted rather than published for the rather obvious reason that they aren't ready yet :-) They will be available in other formats once complete - we know PDF export is possible. Exporting to plaintext is incredibly easy so thats not a problem - though I'm not sure its really worth bothering with that. HTML and PDF should be quite sufficient. Baraboom is looking after all this though really. miko