[drupal-docs] Why we decided to add reference to the drupal handbook in administration help

Gabor Hojtsy gabor at hojtsy.hu
Thu Sep 29 15:23:27 UTC 2005


>> It is not just keeping the clients in the dark, but if you modify some
>> inner working substantially (like I forward ported the 4.4 tracker view
>> to one of my 4.6 sites, since we were accustomed to that view, and were
>> interested in recent comments). Now with changes like this, the admin
>> help links point to some documentation which is not relevant to that
>> exact module I have on the site. Sure, one who modifes Drupal so
>> heavily, can easily remove this part of the help text either by doing a
>> "translation" or by editing the code.
> 
> Wouldn't this be the very small exception rather than the rule for most
> Drupal sites on the web? And if we use this case as a guideline for
> writing docs to go in the admin/help, should't we just leave out
> admin/help all together since potentially the onsite documentation page
> for a module could be invalid?

I already written above that this is an exception, although I worded it
differently :) I just said that there *are* potential use cases where
documentation modification makes sense, besides copying Drupal and
selling it...

Goba



More information about the drupal-docs mailing list