[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