I don't think it is a smart idea to build a documentation website with
Drupal. Drupal doesn't do very well in that respect. Drupal's own book
module has more than its fair share of issues and complaints, and is
one of the reasons why there are so many complaints about Drupal
documentation.

You CAN if you are willing to install and test the necessary
combination of modules, customised templating, and perhaps some CCK

I suggest using a well established wiki or using Drupal with some text
format that makes it easy to translate the documentation into a pdf or
chm format, like markdown or something along those line.

As Massimo has said - if you create the docs he will link to it. Just
agree on what format the docs will be built in, mostly which structure
focused tags are to be used. It is much easier to create a wiki with a
book chapter outline which contains "only" links to contributors pages
on the topic which have the right structure. With the passage of time
it will be easier for the editors to decide what should go into an
'official' manual


@anand
I have looked at site, and I see no signs of  
http://drupal.org/project/geshifilter.
You could probably add betterformats and a few content related
modules. Stay away from any kind WYSIWYG, and consider
http://drupal.org/project/bueditor and http://drupal.org/project/wmyeditor

My advice is to use bueditor or wymeditor to create a set of buttons
and tags based on a small subset of DocBook format and ensure all the
content is entered in that format. Documentation should go in
structured first time around. You really don't want any kind of
wysiwyg in there

It might be tedious initially but such an approach will pay of in the
long term

my 2 cents



On Feb 4, 11:00 pm, mdipierro <[email protected]> wrote:
> http://webtopy.org/community/tips-examples

-- 
You received this message because you are subscribed to the Google Groups 
"web2py-users" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/web2py?hl=en.

Reply via email to