trinity-devel@lists.pearsoncomputing.net

Message: previous - next
Month: February 2012

Re: [trinity-devel] Extending Darrell's script idea

From: Darrell Anderson <humanreadable@...>
Date: Sat, 25 Feb 2012 11:28:59 -0800 (PST)
> I have a marketing/advertising background.  The
> following suggestion is primarily aimed at increasing the name recognition of
> "Trinity Desktop" but should have other useful side effects as well.
> 
> My idea is to start a "Trinity Desktop scripts" webpage or
> forum containing user submitted scripts.  This should be
> interactive and
> monitored so I think something like a forum would be the
> best idea.
> The site/page would be based around the concept of "Useful
> scripts
> that can help you to learn scripting as well".  It
> would include
> scripts that could be used from Konsole or from inside Kate
> or Konqueror (which sometimes have to be structured differently
> than standard scripts). Information on how to use scripts inside
> Kate and Konqueror would also be available.
> 
> To have a script accepted, a vote or committee approval
> would be
> needed.  Besides being useful (either in actual use or
> in learning to
> script) the script would have to be heavily documented by
> the writer
> so that the "what" and "why" of the script could be
> understood by
> users not familiar with scripting (the majority of them).
>
> Thoughts?

I like the idea.

> Another useful page/site similar in effect to the above
> would be one that specialized post and information on how to modify the
> appearance and function of menus, toolbars, popups, etc. for Trinity
> Desktop programs.

I like the idea. For delivery I prefer to see all of the help documents available online at the web site or wiki as HTML files. When users submit tips we update the appropriate help file DocBook source. The respective HTML file gets regenerated nightly and becomes an updated live web page within 24 hours.

That way we keep our help files current and treat them as living documents. By doing that we keep the information contained to a single source and don't have to duplicate our efforts.

With all of the help files in DocBook format, we can revise certain files into smaller bite size files, which then can be sourced into other DocBook files to form a complete document.

Darrell