You are here: Home / Blog / posts / Pixelworkers of CAES DO / It was a little too quiet around here....

It was a little too quiet around here....

by randles — published Nov 19, 2010 03:20 PM, last modified Jan 28, 2014 02:54 PM
Trish and I have been doing less blogging recently and more documentation for our knowledge base. I wanted to take a quick break and explain how we organized and how it has helped!

To the two people out there who read my blog posts (Trish and my mother) you may have noticed that I have not been posting recently, my deepest and sincerest apologies.  I still do use Plone everyday but I have been working on our documentation instead of blogging.  I figured this would be a great opportunity to explain the "kb" folder on our site and how we decided to structure our content.

As usual we have some words of warning, storing Plone documentation in Plone is dangerous, if your Plone instillation breaks will losse access to  your documentation (you will have to hope google has an index of it and you can look at the google cache of the page)

The structure of our kb folder looks something like this:

KB
 |-generic
     |-products
        |-faculty staff directory
     |-training
 |-caes
     |-how to edit the splash image
 |-ffhi
     |-faculty staff directory

In the knowledge base there are two types of information: specific and general.  All general information (how to use Plone, how to add a staf member, and how to use collective.uploadify) is documented in the generic category and all screen shots use a generic Plone 3 installation.  The second category, specific information, we organize by website/center.  In this category we list specific customizations or how to's that do not apply to other sites, for example, we have documented how to change the splash image on the college site in the CAES folder. You may have noticed faculty staff directory is listed twice above, this is because the general how to is listed under generic > products but the specific information about how to update it on the FFHI website is listed under FFHI

The blog is aimed at the general Plone Community and the knowledge base is aimed at our users.  In the knowledge base there are protected folders and pages, I am sorry if you encounter any of these but not all of the information there is meant for the general public. If you have any questions we are happy to help, just ask! 

 

 

When:

Where:

Contact