Carolyn Duangprom

August 3, 2007

Hot Docs! Latest Admin Manual and Install Guide now available

Filed under: New Releases — carolyn @ 5:11 pm

The latest versions of the KnowledgeTree Administrator Manual and the KnowledgeTree Install Guides are now available.
If you’re the sort who prefers to download our documentation direct from SourceForge (without the useful links from our funky new website or the KnowledgeTree Documentation site), then you’ll see that, because KnowledgeTree is a Commercial Open Source system, we don’t remove or hide older documentation sets at SourceForge - you can always identify the latest documentation from the last date stamp. In this case:

  • KnowledgeTree Administrator Manual 2007-08-03
  • KnowledgeTree Install Guide 2007-07-23

KnowledgeTree Documentation is available for download in PDF format, or you can view the browser-based Online Help, which should be available in a few days.

A Manual is a Manual is a Guide - so what’s up with KnowledgeTree Docs

I realize that you’re probably not rushing to download KnowledgeTree Documentation to read over the weekend or on any lazy sunday at the pool or fireside (depending on where in the world you are) - and if you are, pleeeze drop me a line; I must meet you :)
So, in an ongoing and continued effort to make things simpler through this Docs review process, I’ve wrestled with structure and content, and with a few of you, dear User Audience, with whom I, normally stuck in a dank writing corner, sometimes have the glorious opportunity to engage with on the topic of what’s hot and what’s very definitely not in the KnowledgeTree docs. Your comment, criticism, and suggestions are always in the back of my mind as I drive my way around the system and journal my findings.

Having said this, we have to satisfy a global, diverse audience. KnowledgeTree has wide application - since it’s commercial open source and simply open source, many different types of organizations and users are able to download the system and implement it in the way that suits them best. We love this groovy energy about you and KnowledgeTree; but for now it means our Documentation has to be a detailed Reference more than definitive ‘How To’ guides. As the product evolves and grows, we’ll build resources on how substantial groups of users and organizations are using the system and be able to develop those ‘How to do this exactly’ type of documents. So tell us who you are, and how you use KnowledgeTree; engage with us to tell us what you want to see in the documentation, and what you like and dislike. Also, if a procedure or description doesn’t work for you, please tell us by logging a documentation issue.
More to the point, this is some of what we did …

  • merged several procedures to reduce the number of topics
  • restructured content to make navigating the help and the system more intuitive
  • verified content, added new features and changes
  • documented workarounds
  • added indexes
  • reduced text where possible to make it more direct, taking care to stick to recognizable technical writing style and avoiding jargon where possible
  • reduced the number of screenshots - procedures are fully descriptive and the step-by-step style should not leave you lost
  • we also added a few of those best practice type high level task lists you’ve asked for

Take a look, enjoy, and we look forward to hearing from you as we get the next release of the User Manual ready.

Carolyn

No Comments »

No comments yet.

RSS feed for comments on this post. TrackBack URL

Leave a comment

You must be logged in to post a comment.

Powered by WordPress