Hi, I think it would be enormously helpful to drupal users if a core and contributed modules API site enabled comments. Something like this: http://us.php.net/manual/en/function.is-array.php Is there any reason this couldn't be done? Throwing the idea out there. Is this the right place to post this idea, or is it better discussed somewhere else? Any technical or social reasons we shouldn't do this? I think it would expose so much helpful code to struggling drupalers! There's always wheat and chaff, but people are pretty good at sorting out that stuff. For now, it's tough climbing the learning Drupal learning curve without an annotated functions page like the one on the PHP site. BTW, I'm a huge fan of the contributed module API site at http://api.freestylesystems.co.uk/ Best Regards, Margie
On 3-Feb-09, at 6:58 PM, Margie Roswell wrote:
Hi,
I think it would be enormously helpful to drupal users if a core and contributed modules API site enabled comments.
Something like this: http://us.php.net/manual/en/function.is-array.php
Is there any reason this couldn't be done? Throwing the idea out there. Is this the right place to post this idea, or is it better discussed somewhere else? Any technical or social reasons we shouldn't do this?
Technical reasons, yes. See: http://drupal.org/node/101308, which is postponed pending more important bug fixes like http://drupal.org/node/300031 and http://drupal.org/node/100680 and http://drupal.org/node/84207. In other words, if you want to see this happen, API module needs some love. :) -Angie
Excellent response. Basically, I want to fix the gaping holes in documentation, like objects not being documented, before adding new features. Additionally, some infrastructure issues need to be solved. api.drupal.org is currently a separate site. There is no way I am making another place to log in. We need to get single sign on working or merge sites first. We will be tackling this at the redesign sprint in Paris (http://drupal.org/node/356002). I will work with the documentation team to set the comment policy. A new place to add comments means we will also get spam, useless comments and comments that should be incorporated into the main documentation. -Neil On Tue, Feb 3, 2009 at 7:03 PM, Angela Byron <drupal-devel@webchick.net> wrote:
On 3-Feb-09, at 6:58 PM, Margie Roswell wrote:
Hi,
I think it would be enormously helpful to drupal users if a core and contributed modules API site enabled comments.
Something like this: http://us.php.net/manual/en/function.is-array.php
Is there any reason this couldn't be done? Throwing the idea out there. Is this the right place to post this idea, or is it better discussed somewhere else? Any technical or social reasons we shouldn't do this?
Technical reasons, yes. See: http://drupal.org/node/101308, which is postponed pending more important bug fixes like http://drupal.org/node/300031 and http://drupal.org/node/100680 and http://drupal.org/node/84207.
In other words, if you want to see this happen, API module needs some love. :)
-Angie
-- Neil Drumm http://delocalizedham.com
participants (3)
-
Angela Byron -
Margie Roswell -
Neil Drumm