[drupal-docs] Moving handbook to docs.drupal.org

Gabor Hojtsy gabor at hojtsy.hu
Fri Mar 18 10:15:41 UTC 2005


> Third, I can see why starting clean feels comfortable.  Right now, making 
> changes to the handbook makes people feel uncomfortable: "Has this page been 
> rewritten recently?" , "Can I remove this page?", "Do I step on some people's 
> toes if I modify this page?", "Would someone be working on this?", ...

What I see as a problem with the docs on drupal.org as I expressed to you 
in person before is that we cannot see the changes (ie. documentation page 
change diffs are not posted to the mailing list)

    This is why we don't know that there is work done, or that someone
    is doing some reorganization here and there, and this is why we
    are uncertain to modify and improve stuff. At least me :)

    I do think it is crucial to see and be able to track the changes.
    After being a phpdoc team member for years, I suggested that
    we employ a versioning system for our websites and docs in Hungary,
    and it had a tremendous productivity effect, since we see the work,
    we can truly collaborate. We even store the static pages of
    weblabor.hu in SVN, and not as page nodes, since we can see when
    things are changed, and what are the changes.

    This will not change with a move...

The documentation team might need some different infrastructure, modules 
installed, etc. docs.drupal.org might need some permission module 
installed to control who can work on what, and it would be a big penatly 
to push this burden on 'usual nodes' (ie. forums) on drupal.org too...

But as others are pointed out, it does not seem to be possible to keep 
drupal.org as a user community and a developer community. It is 
historically a development community, but now increasingly a user 
community too, and it is frustrating to get lost in trying to find out 
what information is for a user and what is for a developer... This is 
also something which is not immediately solved with moving out the docs, 
but people already suggested that we start a user community site 
(support.drupal.org?) and move support there... Then drupal.org can be 
kept as a product presentation site and a development community (which two 
are still quite different to mix...). I must admit that one of the key 
points I liked about Drupal when I joined was that everything was 
accessible from Drupal.org, support, downloads, everything... Now with the 
increased size of the project and userbase, this is less and less possible 
to achive...

Goba



More information about the drupal-docs mailing list