OK. I hope people take a look at this post. I recently posted: http://drupal.org/node/32977 - "A Newbie's Point of View" where I and some others lists complaints about the Drupal.org documentation. Well, this is my first attempt at answering those complaints. I'm going to submit a page to the handbook called "Advanced User's Guide" under Configuration & Customization in the handbook, and I want your input. Here's my rough draft of the text:

"You've installed Drupal and got it working. You're added a module or two, and maybe you're even changed the theme around. Now it turns out, you want to do more and adding modules or changing the options don't seem to cut it. Maybe you've found that things don't look quite like you want, or you want there to be more functionality in a particular module.

Specifically for Modules

If you have problems with a specific core module, a great place to start looking is the module handbook. Or, if you have an issue with a user made module, check out contributed modules handbook. Another place to look for issues or bugs in contributed modules is: Module downloads page. Click on "Find Out More" under your specific module, and then click on "View pending bug reports" or "View pending feature requests" under "Support" to see if someone has already addressed the issue. The next place to go is to the forums, and search for

Hi All!
wrote a module for Drupal and want to generate the documentation with phpdoc. The problem is, i get Error "nothing parsed", because my file has extension *.module and the phpdocumentor means it isnt a php file. If i rename it to *.php then is OK.

Questions:

How can i get phpdoc to parse *.module files?
Maybe exists some ini where i can extends parseractivity?

Thx for responce
I

This comment written Sept 25, 2005; Current release of Drupal is 4.6.3

I am setting up a website for a small non-profit, primarily to give them the benefit of being able to easily edit their website, and perhaps to take advantage of other CMS features in the future. This means I'm not concerned about setting up comments or forums or votes at this point, but my primary focus is changing the 'look' to what we want. Drupal looks pretty good, so I've installed it, and have now started reading the documentation to figure out what I need to do to put together a theme for our site.

However, it seems that the documentation for Drupal doesn't follow a particular version of the software; this means that documentation, for example, for the Theme Developer's Guide, will have some pages written for 4.7, others written for 4.5.x, and others for 4.6.x, but the end reader won't know which version a particular page is talking about unless the author expressly mentions it in the body. To make it more confusing, when you go from one node to the next, the documentation may well be for a different version than what you are using - but nothing tells you this.

For example, the second node in the Theme Developers Guide,, http://drupal.org/node/29140, does indicate, in the text that it is talking about a feature - regions - that is not introduced until 4.7, which at the time of writing is CVS. If you keep clicking on to the 'next' page in the documentation, one might assume that each subsequent page is still talking about 4.7, as there isn't any further mention of versions. However, in the phptemplate documentation, at http://drupal.org/node/29140, there is a comment that the documentation is out of date as of 4.6.x - presumably the page in question was written for 4.5.x. So now a reader is thinking - what about all the other pages I just read through? What version were they talking about? Are the instructions different for the version I am using?

I'm new round here, but shouldn't this page:

http://drupaldocs.org/api/head/function/theme_comment

Be linked to from here:

http://drupaldocs.org/api/4.6/group/themeable

and, while we're at it, here:

http://drupaldocs.org/api/head/group/themeable

It took me ages to work out how to theme the comments!

Currently the description of Drupal Licensing is limited to the following passage in About Drupal » Background » Mission of the Handbook pages:

Open source. Drupal is based on the open source philosophy of collaborative free software development and is licensed unde the GPL. Drupal is itself open source and builds on and supports other open source projects. Specifically, Drupal is coded in the open source scripting language PHP and supports as primary data sources the open source database formats MySQL and Postgresql.

Given this weekend's discussions and earlier remarks there seems to be a need for "official clarification".
The information should:

Just a method for people who wants to show PHPinfo inside Drupal

PHPinfo Description:

Outputs a large amount of information about the current state of PHP. This includes information about PHP compilation options and extensions, the PHP version, server information and environment (if compiled as a module), the PHP environment, OS version information, paths, master and local values of configuration options, HTTP headers, and the PHP License.

go to
Admin>content>create>page (or sniplet)
copy and paste the code below