[documentation] [Documentation task] For discussion: Should we remove the "You can" links from module help?

webchick drupal-docs at drupal.org
Sun Nov 5 03:03:04 UTC 2006


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

 Project:      Documentation
 Version:      <none>
 Component:    Documentation in CVS
 Category:     tasks
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  webchick
 Updated by:   webchick
 Status:       active

A long-standing issue with synchronizing the module help in
admin/help/module_name with that in http://drupal.org/handbook/modules
are those darn "You can" links at the bottom that say things like:


You can



* administer forums at administer >> content management >> forums [1].
* enable the required comment and taxonomy modules at administer >>
site configuration >> modules [2].
* read about the comment module at administer >> help >> comment [3].
* read about the taxonomy module at administer >> help >> taxonomy [4].

The problem is we can't link to actual paths on Drupal.org, since they
will be 404s/403s in many cases, which totally befuddled and frustrated
users. And we made many attempts of encoding these in an arcane way so
that they could be parsed out with a script, but that was also
cumbersome and only ever done for the core pages, not contrib.


Now that 5.0 has the "administer by modules" page, can we safely remove
these links from core help and the admin help text in the handbook
documentation?


[1] http://drupal.org/admin/content/forum
[2] http://drupal.org/admin/settings/modules
[3] http://drupal.org/admin/help/comment
[4] http://drupal.org/admin/help/taxonomy




webchick



More information about the documentation mailing list