CMS Evaluation for Multilingual Documentation Maintenance
From Apache OpenOffice Wiki
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.
Requirements
Enter requirements that a content management framework should meet. Think problem, not solution.
Requirement | Description | Priority | Notes |
---|---|---|---|
Usability | Easy of use and unambiguousness for end users
|
High | if the intended target audience for the tool is the end user (if not, cancel this req!) |
Easy translation process | with one mouseclick to template for translation The translation is reached by a flag-language-changer. |
High | |
Different documentation formats | Different mimetypes are allowed to up- and download. ODF-Files and PDF-Files are displayed inside the framework without converting. |
High | See and read online, what you could get :-) |
Workflow management | Different areas of documentation types: from lower proof of quality to high proof (with workflow). Management of rights for every object inside the framework (directory, file etc.) |
High | Like in OOoAuthors we also need documentation with high quality ;-) |
Draft Documentation | Documentation, which are in work and not finished could hold status private. | high | Work could be saved on the server (also it is not fished and ready for publishing) |
Dynamic navigation bar | A dynamic and quick to use navigation bar to navigate in the structure. Easy change to another language (with language changer / flag) | high | |
Different skins /views for anonymous visitors and contributors | An anonymous visitor needs only displayed content. A contributor needs a framework with tools (for editing etc.) | high | |
Modularity | Being able to aggregate content modules in different documentation types | high | |
Automatic output to PDF/ODF | for post-processing, for example hardcopy publishing, bundling | medium | |
API for automated content processing | for implementing bot-based changes, accessing content from outside and feed them into other (publication) processes | medium | |
Extensible | for being able to extend the framework with additional functionality (for example, thru plugin technology) | medium | |
Controlled access | Making sure that access rights can be controlled. Users must agree to Terms of Use and sign Contributor Agreement. | high |
{{Spacer|20}
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 |
|
|
Mediawiki with Extensions |
|
| |
Drupal | Very popular CMS |
|
|
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. |
|
Learning curve? |