[GE users] Documentation in PDF gone?

reuti reuti at staff.uni-marburg.de
Mon Mar 2 11:37:32 GMT 2009


Am 27.02.2009 um 00:30 schrieb skonta:

> The wiki is a forum that  we hope promotes faster updates and  
> community involvement. As a living document that anyone has the  
> ability to add to or comment on, the potential is limitless. There  
> are some limitations to the PDF format, as this is a relatively new  
> tool. However, they should be improved in the future.
> On 02/26/09 13:53, reuti wrote:
>> Hi Chris, Am 26.02.2009 um 21:13 schrieb craffi:
>>> I actually disagree and prefer the online Wiki and I'm speaking  
>>> as someone who has spent a ton of time printing and binding the  
>>> various versions of prior manuals over the years. SGE  
>>> documentation has always been an issue, mostly because to  
>>> generate the Admin and User guides, Sun actually had to go out  
>>> and hire technical writers to put things together after first  
>>> spending lots of time with the dev team. The tech writers never  
>>> knew or used the product and had to rely on speaking with the dev  
>>> team.
>> well, the documentation was written in Framemaker* on Sparc (at  
>> least 5.3 has entries in "Properties" in the Adobe Reader) - not a  
>> widely used configuration I fear. Having this in something like  
>> LaTeX would trigger someone from the community easier to step in.
>>> Invariably this caused a massive lag in the documentation in that  
>>> the Guides would be very very far behind when it came to current  
>>> SGE behavior, configuration and features. Remember how long it  
>>> took for Resource Quota stuff to end up in the "official" docs  
>>> for SGE 6.x? Moving into the wiki removes this 6-month or more  
>>> delay (or potentially does ...) and I think longer term this is  
>>> of larger benefit than losing easy access to book-formatted  
>>> documents. (Just my $.02 of course).
>> If Wiki and PDF would be the target: isn't there any "meta- 
>> language" to prepare the docs and generate out of it Wiki and PDF  
>> - both with nice bookmarks?
> The source was moved into SGML (using ArborText Editor, not Frame 
> +SGML) sometime between the 5.3 and 6.1 releases. Unfortunately, we  
> don't yet have a "one-touch" solution for SGML to wiki, nor do we  
> have an easy way to move information back from wiki into SGML. We  
> are, however, working on some possible solutions. If any of you  
> would like to help us develop those solutions, either by giving us  
> some specific requirements or by helping to test, that would be  
> wonderful.

another option would be to move to GNU Texinfo besides LaTeX. I'm  
curious about the commercial customers of SGE: they don't complain  
when you say: we have no printed documentation, use the wiki?

-- Reuti

> Best,
> Sandra
>> *) Is Framemaker still used for technical documentation, it got a  
>> little quiet about it? I thought the idea of Framemaker and its  
>> SGML was to create documents out of databases. For the SGE  
>> documentation this feature isn't necessary I think. -- Reuti
>>> I'd be interested in using the wiki to create short booklets or  
>>> cheatsheets. Maybe there is some way we can scrape the wiki  
>>> articles to get text or XML we can turn into PDFs or something. - 
>>> chris On Feb 26, 2009, at 3:01 PM, crhea wrote:
>>>> On Thu, Feb 26, 2009 at 02:54:00PM -0500, prentice wrote:
>>>>> I prefer PDF documentation that came with the earlier versions  
>>>>> myself. I do not like the wiki documentation for 6.2 at all. --  
>>>>> Prentice
>>>> I agree. While Wiki docs serve a purpose, they seem to be a  
>>>> moving target. I'll take a PDF that I can download and point my  
>>>> users at any day. --- Cris
>>> ------------------------------------------------------ http:// 
>>> gridengine.sunsource.net/ds/viewMessage.do?  
>>> dsForumId=38&dsMessageId=115438 To unsubscribe from this  
>>> discussion, e-mail: [users- unsubscribe at gridengine.sunsource.net].
>> ------------------------------------------------------ http:// 
>> gridengine.sunsource.net/ds/viewMessage.do? 
>> dsForumId=38&dsMessageId=115464 To unsubscribe from this  
>> discussion, e-mail: [users-unsubscribe at gridengine.sunsource.net].
> <Sandra_Konta.vcf>


To unsubscribe from this discussion, e-mail: [users-unsubscribe at gridengine.sunsource.net].

More information about the gridengine-users mailing list