[documentation] [Documentation bug] Questionable pages in the Installation and configuration handbook
webchick
drupal-docs at drupal.org
Wed Jan 10 17:59:45 UTC 2007
Issue status update for
http://drupal.org/node/108285
Post a follow up:
http://drupal.org/project/comments/add/108285
Project: Documentation
Version: <none>
Component: Installation
Category: bug reports
Priority: normal
Assigned to: Anonymous
Reported by: vjordan
Updated by: webchick
-Status: active
+Status: fixed
Thanks. Deleted Dobro's blog and My presentation. There were actually
about 10 pages there that didn't belong (some support requests, some
with just like 3 lines, a CVS shell script, some devel info about the
node table, a draft of a new post, etc....), so did some additional
deleting and re-shuffling.
I'm really hoping this newish "allow anyone to create a handbook page
anywhere" thing is actually providing Drupal with more good
contributions than bad. I've been deleting A LOT of spam/stupid book
pages lately, it seems... esp. in the installation and configuration
guide, since that's the first place a page will go if they don't change
the selection.
We'll maybe have a think about some kind of code-level solution to this
problem... maybe "locking" the addition of top-level book pages to
members of the doc team, or selectively turn on moderation queue for
specific books, or only allowing people to post book nodes after they've
posted a valid issue to the issue queue, or...
Btw, I don't really know what to do about "tipps"
http://drupal.org/node/70626 ... the user here has some good intentions,
but the language, spelling, grammar, etc. don't make it very appropriate
for the handbook, esp. at the top level. For now I moved it under the
"Site recipes" section, which seemed to be kind of a mish-mash of user
contributed suggestions, but that's not right either.
webchick
Previous comments:
------------------------------------------------------------------------
Wed, 10 Jan 2007 14:48:02 +0000 : vjordan
The Installation and configuration handbook [1] has some questionable
pages at the top level (the main contents links). It would be better if
these were placed in a more appropriate area. They might fit better in a
'temporary' or 'working space' until they are refined enough to bring
some value into the handbooks.
Three pages stand out from the rest on this: Drupal 4.7 configuration
all around very very short tipps [2], the not so informative My
presentation\" [3] and finally Dobro's Blog [4].
It may also be appropriate to do a one-to-one intervention with the
authors to outline more appropriate places for this stuff.
[1] http://drupal.org/node/258
[2] http://drupal.org/node/70626
[3] http://drupal.org/node/72898
[4] http://drupal.org/node/108242
More information about the documentation
mailing list