[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