Re: Eclipse for doc releases

Subject: Re: Eclipse for doc releases
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 18 Jun 2009 09:16:28 -0700

Eclipse help works pretty well on a Web server works pretty well.
(Web-served Eclipse help is an "Infocenter" in Eclipse jargon.)

I evaluated it for that purpose and went with OmniHelp instead, mostly
because at the time it was not clear how to install Eclipse help into
an existing Tomcat instance.

On Thu, Jun 18, 2009 at 4:35 AM, Chris
Despopoulos<despopoulos_chriss -at- yahoo -dot- com> wrote:
> I actually looked into this a few years ago. In our case, it was appropriate to have a server-based doc delivery since the product was server based, and different users could have access to different components. The problems of load time for the doc system were NA because the doc server started up with the product.
>
> I looked at this a few releases ago (pre-Europa), and Eclipse changed its architecture somewhat. The last time I looked I never found an obvious separation of the doc server, and since the idea was abandoned by those above, I quit looking. The old doc subset was very small, and based on Tomcat...  Not sure what's up with Europa and Ganymeade.
>
> I thought this was an excellent way to go. You can install and serve the docs from the user's desktop (make the server a service so it loads as the machine starts up), from a server on the LAN, from a VM appliance, or from a server on the WAN. It gives you all the usual goodies (search, TOC, etc.) and a great update mechanism.  Plus you have hooks to implement role-based access to doc sets.
>
> Frankly, I believe that in the not-too-distant future we'll all use servers they way we currently use desktop apps. Look at the JEdit text editor for an example of a tiny server that manages what is usually a desktop process. (Overkill?  Perhaps, but it's still interesting.)  Using Eclipse to deliver docs may indeed be appropriate for you, and a good idea. I hope you keep the list posted on your progress.
>
> cud
> http://www.cudspan.net
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices.
http://www.doctohelp.com/SuperPages/Webcasts/

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Re: Eclipse for doc releases: From: Chris Despopoulos

Previous by Author: Re: How Do You Decide How Long Things Will Take (in a SCRUM Shop)?
Next by Author: Re: Eclipse for doc releases?
Previous by Thread: Re: Eclipse for doc releases
Next by Thread: RE: Any more dullards out there ..


What this post helpful? Share it with friends and colleagues:


Sponsored Ads