trinity-devel@lists.pearsoncomputing.net

Message: previous - next
Month: March 2011

Re: [trinity-devel] Trinity End-User Documentation

From: Darrell Anderson <humanreadable@...>
Date: Wed, 9 Mar 2011 12:24:43 -0800 (PST)
1. Does anybody know where we can grab the old KDE3 web site? Hopefully all of that info is archived somewhere and can be migrated to the Trinity web site?

2. The current KDE web site has a nice intro to the desktop environment (http://userbase.kde.org/). All content is licensed under Creative Commons License SA 3.0 and the GNU Free Documentation License 1.2. We could save time my imitating most of the overall structure.

3. I have copies of two KDE3 user guides in PDF. One is from OpenSuse 11.0 and the other from the Asia-Pacific Development Information Programme. Lots of good info in both. There likely are some other guides that we can use. Please let me know.

4. I found the following: http://userbase.kde.org/How_To_Convert_a_UserBase_Manual_to_Docbook. Currently this stuff makes my eyes water --- all Greek to me at the moment. :)

Darrell


--- On Wed, 3/9/11, Darrell Anderson <humanreadable@...> wrote:

> From: Darrell Anderson <humanreadable@...>
> Subject: [trinity-devel] Trinity End-User Documentation
> To: trinity-devel@...
> Date: Wednesday, March 9, 2011, 12:42 PM
> I have close to 3 decades technical
> writing experience. Naturally, I have an interest in any
> documentation packaged with Trinity. :)
> 
> The Help files need serious attention. In KDE 3.5.10 many
> Help files are out-of-date. Eventually we have to update
> those Help files.
> 
> I don't know how the original Help files were maintained or
> created. I need help and direction with that.
> 
> I want to see an overall user guide to Trinity. The guide
> would be available in two forms: HTML and PDF. The HTML
> version would be a desktop shortcut available to all users
> who first install Trinity and should be a menu option for
> those who delete the shortcut.
> 
> I am willing to lead this part of the project. I face an
> immediate challenge: my background is overwhelmingly with
> paper products and not electronic. I need help and advice
> with the tools I need to learn to produce two different
> outputs (HTML and PDF). OpenOffice Writer (now LibreOffice)
> might be a choice, but I suspect the HTML output will leave
> much to be desired. Some sort of structured authoring
> front-end would makes sense (DocBook?), but that means a lot
> of sweat equity to massage the back end formatting. The
> system used to produce the original Help files might be a
> solution.
> 
> I am open to ideas and discussion.
> 
> Darrell
> 
> 
>       
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: trinity-devel-unsubscribe@...
> For additional commands, e-mail: trinity-devel-help@...
> Read list messsages on the Web archive: http://trinity-devel.pearsoncomputing.net/
> Please remember not to top-post: http://trinity.pearsoncomputing.net/mailing_lists/#top-posting
> 
>