Changes between Version 3 and Version 4 of Documentation


Ignore:
Timestamp:
Feb 13, 2014, 1:31:24 PM (5 years ago)
Author:
Anna Tomanek
Comment:

Replaced obsolete content with links to current resources.

Legend:

Unmodified
Added
Removed
Modified
  • Documentation

    v3 v4  
    1 [[TOC]]
    2 
    31= Documentation =
    42
    5 The official documentation of FCKeditor is available at:[[BR]]
    6 http://docs.fckeditor.net
     3The '''developer documentation''' for the latest CKEditor version is available at:[[BR]]
     4http://docs.ckeditor.com
    75
    8 == Plans ==
     6It includes the [http://docs.ckeditor.com/#!/guide Developer's Guide] as well as [http://docs.ckeditor.com/#!/api CKEditor JavaScript API] documentation.
    97
    10 The documentation is about to be reviewed. We must find a good solution considering the following:
    118
    12  * Better Structure: review the Table of Contents; (DONE)
    13  * Separate "Developer's Guide" from "User's Guide"; (DONE)
    14  * Wiki: easy to update; (DONE)
    15  * Distribute in different formats: browsable HTML, HTML single page, CHM and PDF.
    16  * Translatable
    17 
    18 Other than that, the documentation site will be moved to "docs.fckeditor.net".
    19 
    20 === Better Structure (DONE) ===
    21 
    22 The current Table of Contents must be completely reviewed and well defined. It must be intuitive and easy to use, other than complete.
    23 
    24 === Developer's Guide (DONE) ===
    25 
    26 The "Developer's Guide" is the first reference for those who are starting with FCKeditor, and also for developers looking for advanced features of it.
    27 
    28 The 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.
    29 
    30 === User's Guide (DONE) ===
    31 
    32 Today, 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.
    33 
    34 === Wiki (DONE) ===
    35 
    36 We believe that Wikis are the best way to create and maintain a collaborative documentation.
    37 
    38 Today 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.
    39 
    40 We'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.
    41 
    42 ==== Search ====
    43 
    44 The Wiki site, being the main documentation resource, must be searchable.
    45 
    46 ==== Vandalism ====
    47 
    48 In 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.
    49 
    50 Unfortunately, that's the way thinks must be done in this wonderful world.
    51 
    52 === Distribution ===
    53 
    54 Other 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.
    55 
    56 We should support the following distribution formats:
    57 
    58  * Browsable HTML: a series of HTML pages;
    59  * Single HTML page: a single HTML page with the entire documentation. Some people prefer it for because of its "searcheability";
    60  * CHM: the Microsoft help file format, preferred by Windows users for being a single browsable file (like a mini site) and searchable;
    61  * PDF: for good quality printing.
    62 
    63 We 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.
    64 
    65 === Translations ===
    66 
    67 The 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.
    68 
    69 == Contributors Roles ==
    70 
    71 Documentation 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.
    72 
    73 === Documentation Manager ===
    74 
    75 Current contributor: ''none''
    76 
    77 This 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.
    78 
    79 Even 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.
    80 
    81 The Documentation Manager is someone with good knowledge of usability and management.
    82 
    83 === Documentation Writer ===
    84 
    85 Current contributors: ''none''
    86 
    87 All 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.
    88 
    89 === English Documentation Reviewer ===
    90 
    91 Current contributor: ''none''
    92 
    93 Being 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.
    94 
    95 It is important to remember that this project is maintained mainly by non-native English speakers.
    96 
    97 === Documentation Translation Manager ===
    98 
    99 Current contributors: ''none''
    100 
    101 This is a "per language" role, which guarantees that the translation offers the same quality as the original.
    102 
    103 === Documentation Translation Reviewer ===
    104 
    105 Current contributors: ''none''
    106 
    107 As 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).
    108 
    109 ----
     9The old documentation site contains documentation for CKEditor 3, CKEditor for ASP.NET, CKEditor for Java, CKEditor for Drupal, and CKFinder:[[BR]]
     10http://docs.cksource.com
© 2003 – 2019 CKSource – Frederico Knabben. All rights reserved. | Terms of use | Privacy policy