Re: documentation and the book module (was reflections on the Drupal 4.3.0 battle)

Dries Buytaert <[email protected]> Thu, 23 Oct 2003 13:45:01 +0200 (CEST)
Newsgroups gmane.comp.php.drupal.user
Message-ID <[email protected]>
On Thu, 23 Oct 2003, Kjartan Mannes wrote:
> What I think we need is:
>
>   * A way to bring all the documentation into one place so it can be
>     edited independently of source code or anything else. This of course
>     means that Drupal somehow has to be able to access the documentation
>     for the help.module, or we have to give up on combining them and
>     maintain them separate.
> 
>   * Support for several versions of the documentation for each of the
>     Drupal releases.
> 
>   * Transparent updating that can be reviewed by the community, either
>     before it is included or afterwards (requires revision control of
>     some kind).
> 
>   * A consistent form of structure and styling.
> 
>   * Editable in some form by people who are not necessarily technical in
>     nature.

Additional requirement:

* The documentation should be translatable.

-- 
Dries Buytaert  ::  http://www.buytaert.net/
-- 
[ Drupal user list | http://list.drupal.org/ ]
[ http://lists.drupal.org/options/drupal-user/gcpdu-drupal-user%40gmane.org ]