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

Gábor Hojtsy drupal-docs at drupal.org
Wed Nov 15 17:35: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:   Gábor Hojtsy
 Status:       active

Question is if these "you can" lists really overlap with the new per
module admin pages. I am not sure. But by the way, these lists were hard
to translate too (we need to strictly look at the menu item translations
when translating these strings).




Gábor Hojtsy



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

Sun, 05 Nov 2006 03:03:02 +0000 : webchick

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






More information about the documentation mailing list