Re: Online documentation platforms

Subject: Re: Online documentation platforms
From: Craig Haiss <craighaiss -at- yahoo -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 15 Dec 2009 03:51:44 -0800 (PST)

Based on my experiences as a blogger, I have a hunch that WordPress or any similar blogging/CMS tool would make an excellent content management system for online documentation.

Blogging tools have simple publishing interfaces that would allow writers to focus on content instead of non-essential HATT features. Also, the built in search present in most blogs gives users the ability to navigate in a familiar way. (The use of a TOC or index for online documentation seems to be declining.)

WordPress may lack some of the customization options writers would need for tasks like single-sourcing (although it might work since many blogging tools turn posts into XML), but often expensive HATTs are filled with features that writers don't need.

I'd definitely be willing to give WordPress or another blogging tool a try if it seemed to fit the job. Compared to the headaches involed in working with a HATT, mastering tricky features, installing updates, etc. it would probably be a relief to work with a simple blogging platform installed on someone else's server.

Craig Haiss
Blog: http://www.helpscribe.com


--- On Tue, 12/15/09, David Neeley <dbneeley -at- gmail -dot- com> wrote:

> From: David Neeley <dbneeley -at- gmail -dot- com>
> Subject: Online documentation platforms
> To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
> Date: Tuesday, December 15, 2009, 2:50 AM
> I ran across a brief blog post this
> morning regarding the use of
> WordPress as an online documentation platform (instead of
> Mediawiki,
> in the cited case).
>
> A part of the changing landscape of information delivery is
> the
> implementation of very powerful tools for Web-based
> information
> delivery--and WordPress seems very much at the forefront of
> this. What
> started as a blogging platform has now morphed into a
> popular content
> management system used by many companies for their Web
> presence.
>
> With the rapid spread of web-based applications--whether
> Internet-based or behind a corporate firewall--it seems
> logical that
> new and somewhat more flexible platforms for documentation
> should be
> included. A WordPress platform for doing this might make
> great
> sense--after all, there seems to be a countless stream of
> plug-ins
> available for it, as well as the ability to create your own
> social
> network (BuddyPress) and user forums (BBPress).
>
> This could be a very good thing for technical documentation
> types to
> become well versed in--a process made easier since
> WordPress is free,
> and can serve as a tremendous platform for personal
> websites and blogs
> as well.
>
> The brief article is at
> <http://dougal.gunters.org/blog/2009/12/14/wordpress-as-a-documentation-platform>
>
> David





^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
http://www.doctohelp.com/

Help & Manual 5: The all-in-one help authoring tool. True single- sourcing --
generate 8 different formats and as many different versions as you need
from just one project. Fast and intuitive. 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


Follow-Ups:

References:
Online documentation platforms: From: David Neeley

Previous by Author: Re: Collaborative Documentation Review Process
Next by Author: RE: Accessing documentation when all the tools are from a single vendor
Previous by Thread: Online documentation platforms
Next by Thread: RE: Online documentation platforms


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


Sponsored Ads