Difference between revisions of "Documentation/Dashboard/CMS Evaluation"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Scenarios)
(Requirements)
Line 97: Line 97:
 
|Registration with click-through agreement
 
|Registration with click-through agreement
 
|New users of the framework may need to agree to Terms of Use
 
|New users of the framework may need to agree to Terms of Use
 +
|
 +
|-valign=top
 +
|License maintenance
 +
|Ability to attach different licenses to different content pieces. Ability to track license usage and mixing of licenses in aggregated content.
 +
|
 +
|-valign=top
 +
|Content aggregation
 +
|Ability to aggregate content modules to different documentation types.
 
|
 
|
 
|}
 
|}

Revision as of 11:19, 14 March 2008

Template:Documentation/Banner


This page is intended to collect and discuss requirements, processes, and tools to implement a content management framework that allows maintenance of multilingual documentation.

The goal is to find a way to intelligently create, update, localize, and publish documentation in multiple languages. We are in agreement, that the current Mediawiki-based solution, while having unbeatably low barrier to contribution, lacks basic content management functions required to maintain documentation in multiple languages, and publish documentation that went through review and quality assurance cycles.

Will the CMS also be used as publication platform for users?

Scenarios

Walter is a professional technical writer and would like to devote some of his time and contribute to the OOo documentation. He can do authoring and editing. He is new to CMSs and usually works with Framemaker.

Sheila is an advanced OOo user, a native English speaker, and willing to help out on OOo docs.

Jane is a free-lance author who writes books about OOo and publishes them. She would like to make content available to the community without jeopardizing her ability to earn money with her books.

Francois is a beginner OOo user, a ntive French speaker and would like to maintain some French documents.

Requirements

Enter requirements that a content management framework should meet. Think problem, not solution.

Requirement Description Examples
Access Control Availability of customizable user group access levels, document based, document-type based, or document-status based
Multi-Language Access GUI must be available in multiple languages, swithcing between document languages
Localization Allow for localization of documents, availability of glossary, terminology, translation memory, or interface to external localization tools and formats
Document Workflow Document creation and maintenance must take place inside a customizable work flow including steps to create, edit, review, publish, and archive documents in multiple languages
Document Publication Ability to publish documents internally and to different sites in different formats (ODF, PDF, HTML)
Extensability Framework to add extensions that provide special services, availability of vibrant extension development community
API for programmatic access Ability to automate tasks like mass-changes to documents using API access
Metrics Ability to measure access and usage metrics
ODF support Support of ODF documents, metadata evaluation, search in ODF, ODF diffs, plugging of OOo instances
WYSIWYG support Support of WYSIWYG editor for non-ODF content
Document Versioning Version control of documents, ability to recover/rollback old versions, milestones, creating release tags across different documents/languages
Document Rating Rating of documents by readers (only required if CMS will also be the publication framework)
Comments Add comments to documents by readers (only required if CMS will also be the publication framework)
Ease of Use
Registration with click-through agreement New users of the framework may need to agree to Terms of Use
License maintenance Ability to attach different licenses to different content pieces. Ability to track license usage and mixing of licenses in aggregated content.
Content aggregation Ability to aggregate content modules to different documentation types.

Tools to Evaluate

See also the Wikipedia list of CMSs

Tool Description/URL Pros Cons
Plone CMS built on top of Zope, e.g. http://www.oooauthors.org, http://www.plone.org
  • very low entry threshold
  • dynamic navigation
  • tools for editing like wordprocessor
  • multilingual support right out of the box
  • external editor posible
  • many extensions (products) available
  • ODF files support (also preview inside the cms)
Mediawiki with Extensions
  • supposed lowest entry threshold
  • best suited for setting up a "quick and dirty pilot environment" (e.g. for trying out workflows)
  • very large estension base
  • existing implementation
  • not well suited to implement specific behavior (e.g. automatized workflows)
Drupal Very popular CMS
  • Rich in multilingual and translation support
  • Very widely used, so familiar to users
Alfresco Alfresco is the Open Source Alternative for Enterprise Content Management (ECM), providing Document Management, Collaboration, Records Management, Knowledge Management, Web Content Management and Imaging.
  • sophisticated, enterprise-level CMS
  • ODF integration
Learning curve?
Joomla
Mambo
OpenCMS
O3Spaces
Personal tools