[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