Hi, There /must/ have been some good reason for not including the contribs in the docs. Anyone? However, I cant agree more: we need contribs in drupaldocs as well. Only then can we start ranting and screaming at contrib authors that did not provide proper docs. We can do that now, but its kinda unfair, since there is no real place to do so. Also: I think we must really draw a very clear line between user documentation and developer documentation. Historically these two groups where the same persons in the Drupal comm. But AFAIK this has changed: thus developers and users are two separate gruops now. Users should never have to see information about the theme system etc, while developers should be easily able to avoid docs about what taxonomy is. I am not saying that this is not the case atm, just that it still is a little unclear here and there. Allthough it already has impressively improved lately! Bryghts documentation is a very good example of the user docs IMO. Ber Op vrijdag 13 mei 2005 07:49, schreef puregin:
+1 from me on having contributed modules phpdoc'd on drupaldoc.org also. If it's good to have phpdocs for core modules, then the same benefits accrue from having the same for contributed modules.
One thing that concerns me is how documentation is currently spread out over several different sources. It would be nice to pull everything together on one site. If properly designed, such a site could serve the needs of all documentation users - administrators, developers, users, ...
Was there not a suggestion to establish docs.drupal.org for this purpose?
Djun
On 12 May 2005, at 10:13 PM, Kent Livingston wrote:
Just attempted to install taxonomy access module.
Couldn't agree more.
-----Original Message----- From: drupal-devel-bounces@drupal.org [mailto:drupal-devel-bounces@drupal.org] On Behalf Of Gordon Heydon Sent: Friday, May 13, 2005 12:05 AM To: drupal-devel@drupal.org Subject: Re: [drupal-devel] A little about my morning. - Ranton Documentation
Hello,
Thanks for the pointer, but being a developer the biggest beef I have is the fact the the drupaldoc.org doesn't extend over the contrib modules as well.
Gordon Regards, Bèr -- [ Bèr Kessels | Drupal services www.webschuur.com ]