[documentation] [Documentation bug] Links to drupal.org/admin in handbook

[RobRoy]

Issue status update for 
http://drupal.org/node/58626
Post a follow up: 
http://drupal.org/project/comments/add/58626

 Project:      Documentation
 Version:      <none>
 Component:    User Guide
 Category:     bug reports
 Priority:     minor
 Assigned to:  Anonymous
 Reported by:  RobRoy
 Updated by:   RobRoy
 Status:       active

A few access denied messages is a small prices to pay for helping
thousands of people evaluate drupal applications and use them
effectively.


Kieran, I totally agree.  Clearly, I wasn't saying that we should
either have completely working documentation OR no docs at all.  I
understand a lot of work went into this and I am not detracting from
that.


As I said in my post, I want to contribute and get this fixed.  I've
just joined the doc mailing list and will look into submitting a patch,
any of my time and suggestions I can.


-Rob




RobRoy



Previous comments:
------------------------------------------------------------------------

Thu, 13 Apr 2006 19:21:27 +0000 : RobRoy

http://drupal.org/handbook/modules/notify - 2 links that should just
write out admin/blah instead of link to it




------------------------------------------------------------------------

Thu, 20 Apr 2006 19:05:34 +0000 : RobRoy

Can someone fix the two links on
http://drupal.org/handbook/modules/notify
or if I can rights, I can do it.




------------------------------------------------------------------------

Thu, 20 Apr 2006 21:34:42 +0000 : greggles

It seems that many of the handbook pages have this link included.  


e.g.:
http://drupal.org/handbook/modules/massmailer
http://drupal.org/handbook/modules/node_privacy_byrole
http://drupal.org/handbook/modules/node_import


That could be a convenience feature:


1. copy link to clipboard
2. paste to location bar
3. edit the URL to point to your site




------------------------------------------------------------------------

Thu, 20 Apr 2006 22:09:46 +0000 : RobRoy

Yeah, I understand the motivation behind using drupal.org/admin/blah.  


But the handbook should be geared towards newbies, or those trying to
learn Drupal.  And when they click on a link taking them to an "Access
Denied" page, that reflects poorly on the Drupal community.  We should
replace all those with a written out URL, like
http://www.example.com/admin/blah.


I think it is worth it to go through the handbook and fix all those. 
I'm willing to do it myself if I get rights.




------------------------------------------------------------------------

Fri, 21 Apr 2006 00:25:03 +0000 : Boris Mann

Please look at the guidelines for doing documentation:
http://drupal.org/node/24566


The module help pages need to be formatted in a very particular way.
Yes, the link to "admin" is a bug...the previous link lists the correct
format.


RobRoy: join the documentation list, introduce yourself, and ask for
site maintainer permission (or better yet, just go ahead and edit the
pages...they go into moderation, then we can approve the updates).




------------------------------------------------------------------------

Fri, 21 Apr 2006 00:38:09 +0000 : Amazon

Rob there are hundreds and hundreds of hours that went into the creation
of those handbook/modules/modulename pages.  We tried to make them dual
use for both documentation and for the internal help inside modules.  


Apparently hundreds and hundreds of hours of work is not enough to get
us there.  A few access denied messages is a small prices to pay for
helping thousands of people evaluate drupal applications and use them
effectively.  What we need is more folks to step forward to pay
programmers, systems administrators, and documentors to finish the job.
 Feel free to help out in developing the code to export these pages in
into admin/help module patches.


Kieran




------------------------------------------------------------------------

Fri, 21 Apr 2006 00:53:21 +0000 : webchick

The backstory and outline of problems/possible solutions for this is
available here: http://drupal.org/node/58845


Would appreciate any contributions to help fix this.