Re: Need Clarification

stratagem <[email protected]> Tue, 05 Apr 2005 06:32:35 -0500
Newsgroups gmane.comp.cms.xaraya.documentation
Organization Xaraya
Message-ID <[email protected]>
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.



Chris Dudley wrote:
> jojodee wrote:
> 
>>> Another question.
>>>
>>> If all this is taking place as articles on the website, how is it 
>>> going from there to say a txt file or pdf for inclusion in releases 
>>> or at the very least for download by users?
>>
>>
>>
>> The XUG and MDG will be available in distro when complete, that's 
>> important. Some script prolly and miko was going to address that later 
>> - not sure if himself or not - once the new stuff was available.
>>
> Several folks (including Marcel) have export as PDF working.
> The bit we don't currently have is a way to save lots of articles 
> together as one PDF. But I figure it just needs a custom php script to 
> output one article after another as HTML and then just feed that into 
> the PDF script. None of this is tested yet, but then the docs aren't 
> written yet either :-)
> 
> It was seen as more important to make the documentation articles on 
> xaraya.com so the content could be entered and edited more easily. After 
> all documentation should always be more about the content than its 
> format. We can fudge the format later :-)
> 
> miko