Good day,

(add1sun advised me to post this here.)

How to Install PHP PEAR on WampServer
I created a step-by-step procedure to install and setup PHP PEAR on a
WampServer installation, something many users can and are using on a
Windows based PC these days when creating a development instance.

This was actually intended and a direct result of documenting a procedure
for the contributed module Graphviz Filter
http://drupal.org/project/graphviz_filter which is how I structured the
book.

The complete Drupal book can be seen here:
http://crc-stc.com/Requirements_and_Procedures_to_Utilize_the_Drupal_mod...

I'd like to move this to the drupal.org books now and my questions are,
one, should I make a separate book for the PHP PEAR installation and setup
procedure, (and 'link' the Graphviz procedure to it) and if so where? Or
should I just leave the procedure as it is structured on my site and list the entire
document under the contribute modules, I'm assuming a new section for
Graphviz? Should it be in a specific category?

Please advise,

Varenne

Comments

junedkazi’s picture

junedkazi CreditAttribution: junedkazi commented

Hi,

IF the documentation is more sprcific to the module then you can
add the book pages at
http://drupal.org/handbook/config/contribmodules

But it is more generic like anyone can install the packages irrespective
of the module if they require I would suggest you can add the book pages at
http://drupal.org/handbook/customization/howto
OR
http://drupal.org/node/206647
and then add module documentation at
http://drupal.org/handbook/config/contribmodules
and then add links to installation from your documentation.

Hope it helps.

Thanks

Juned Kazi

Varenne’s picture

Varenne CreditAttribution: Varenne commented

Juned Kazi,

I reviewed your suggestions and links and now feel my best approach is as follows;

1. Post the "Setting up PHP Pear on WampServer" to http://drupal.org/node/206647 or the Installation, migration and backups category. This is generic enough in that it applies to anyone using WampServer on a Windows-based test or sandbox instance for development and testing purposes.

2. Post the Graphviz module related documentation to http://drupal.org/handbook/config/contribmodules

3. Provide links to/from each of these to each other.

4. Notify the module developer of the new documentation link.

New recommendation for the HowTo category:
I feel there should be a sub category in HowTos titled something like Setting up a Development, Test or Sandbox instance for Drupal.

The current Installation, migration and backups category is good, but does not identify or place emphasis on development & testing, which is not hard to do and would encourage others to do their testing out of modules and functionality on and in a non-production environment, as opposed to using a production site for testing, which in my opinion is always a bad idea but still quite a common occurance.

Post getting the above existing documentation set up, I think I'll write another new one for WampServer next, and add that to the Installation, migration and backups sub category as well.

Thanks for the input!

Cheers,

Varenne

add1sun’s picture

add1sun CreditAttribution: add1sun commented

Setting up a dev environment has a section in the Developing for Drupal guide: http://drupal.org/setting-up-development-environment

Varenne’s picture

Varenne CreditAttribution: Varenne commented
Status: Active » Closed (fixed)

Ah, okay I didn't locate that one right away. I'm also marking this as closed now, eventually I will add the documentation to the mentioned locations, just not sure when. Thanks for the assist.