Changes between Initial Version and Version 1 of Documentation


Ignore:
Timestamp:
Jan 23, 2007, 11:03:17 AM (17 years ago)
Author:
Frederico Caldeira Knabben
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation

    v1 v1  
     1[[TOC]]
     2
     3= Documentation =
     4
     5The official documentation of FCKeditor is available at:[[BR]]
     6http://wiki.fckeditor.net
     7
     8It is a Wiki site running over [http://moinmoin.wikiwikiweb.de/ MoinMoin] and hosted by the !MoinMoin creators.
     9
     10Today we have a developer centered documentation, aiming to provide an easy integration and customization of FCKeditor.
     11
     12== Plans ==
     13
     14The documentation is about to be reviewed. We must find a good solution considering the following:
     15
     16 * Better Structure: review the Table of Contents;
     17 * Separate "Developer's Guide" from "User's Guide";
     18 * Wiki: easy to update;
     19 * Distribute in different formats: browsable HTML, HTML single page, CHM and PDF.
     20 * Translatable
     21
     22Other than that, the documentation site will be moved to "docs.fckeditor.net".
     23
     24=== Better Structure ===
     25
     26The current Table of Contents must be completely reviewed and well defined. It must be intuitive and easy to use, other than complete.
     27
     28=== Developer's Guide ===
     29
     30The "Developer's Guide" is the first reference for those who are starting with FCKeditor, and also for developers looking for advanced features of it.
     31
     32The reference to "Developer" here, has nothing to do with "Project Contributors". It refers to our first target instead: developers aiming to use FCKeditor in their projects.
     33
     34=== User's Guide ===
     35
     36Today, no documentation is available for end users. We must provide a complete help to support the editor usage. It must be easy to use, intuitive, and full of screenshots and attractive graphics.
     37
     38=== Wiki ===
     39
     40We believe that Wikis are the best way to create and maintain a collaborative documentation.
     41
     42Today we are using [http://moinmoin.wikiwikiweb.de/ MoinMoin] for it. We are planning to move to [http://www.mediawiki.org MediaWiki], so we will have better control of the installation.
     43
     44We'll be also looking for integrating FCKeditor with !MediaWiki (Wikis in general), so the documentation site will be used as the showcase for this integration.
     45
     46==== Search ====
     47
     48The Wiki site, being the main documentation resource, must be searchable.
     49
     50==== Vandalism ====
     51
     52In the latest period we have had more vandalism to handle than real contributions. Therefore, our new documentation site will not accept anonymous editing. If this restriction will still not work, editing will be available only for approved users, and the comments page will be left for registered users to add their bits.
     53
     54Unfortunately, that's the way thinks must be done in this wonderful world.
     55
     56=== Distribution ===
     57
     58Other than the official documentation web site (the Wiki itself), we want to provide the complete documentation in the FCKeditor distribution package too. We may also think about distributing it in separate downloadable files.
     59
     60We should support the following distribution formats:
     61
     62 * Browsable HTML: a series of HTML pages;
     63 * Single HTML page: a single HTML page with the entire documentation. Some people prefer it for because of its "searcheability";
     64 * CHM: the Microsoft help file format, preferred by Windows users for being a single browsable file (like a mini site) and searchable;
     65 * PDF: for good quality printing.
     66
     67We believe that the best solution would be the export of the Wiki site to the [http://en.wikipedia.org/wiki/DocBook DocBook] format. In this way it would be easy to automatically build the documentation in other formats.
     68
     69=== Translations ===
     70
     71The new documentation site must be prepared to handle the translation of the official documentation. Translations must provide the same quality and efficiency of the original.
     72
     73== Contributors Roles ==
     74
     75Documentation is a big and exhaustive task. But it's also one of the most important things in a software project. Therefore, specialization is needed to well organize it, producing high quality results.
     76
     77=== Documentation Manager ===
     78
     79Current contributor: ''none''
     80
     81This is an important role. The Documentation Manager has a complete overview of the project documentation. He/she must also have in mind the overall objectives of it, and how it impacts in the development process.
     82
     83Even if the Documentation Manager may also write documentation, this is not his/her main task. He/she must actually direct its development and control its quality, by monitoring changes. He/she is also the reference for other documentation contributors.
     84
     85The Documentation Manager is someone with good knowledge of usability and management.
     86
     87=== Documentation Writer ===
     88
     89Current contributors: ''none''
     90
     91All contributors are invited to write documentation, but some of them are specialized on it. They know all writing standards of the project and produce quality texts.
     92
     93=== English Documentation Reviewer ===
     94
     95Current contributor: ''none''
     96
     97Being English the first language in the project, we must provide '''standard''' and high quality texts in that language. Therefore, we must have a good English writer ready to review all texts introduced in the documentation.
     98
     99It is important to remember that this project is maintained mainly by non-native English speakers.
     100
     101=== Documentation Translation Manager ===
     102
     103Current contributors: ''none''
     104
     105This is a "per language" role, which guarantees that the translation offers the same quality as the original.
     106
     107=== Documentation Translation Reviewer ===
     108
     109Current contributors: ''none''
     110
     111As o rule of thumb, every translation must be reviewed by someone else. So, theoretically, we must have two reviewers for each language (one of them may be the Document Translation Manager).
© 2003 – 2022, CKSource sp. z o.o. sp.k. All rights reserved. | Terms of use | Privacy policy