[documentation] 2 Documentation Questions

[Shai Gluskin]

Gang,

In my first attempt to help out with Drupal documentation I've taken on
making improvements to this page:
http://drupal.org/node/115522

[Background -- you can skip to the questions if you like]

It's in the part of the manual about installation profiles. It shows people
how they can perform configurations for various parts of their Drupal site
with scripts instead of lots of clicking and waiting for screens to draw.
And of course, the scripts can be easily saved and used for other sites etc.
A much smaller solution than an installation profile, but a handy set of
snippets indeed.

Unfortunately, the page is very confusing, the examples not always full, and
there is no explanation of what possible different values each attribute can
take, whether that attribute is required and what precisely it does.

What I've done so far is make the Add Taxonomy Vocabulary sample script much
fuller, and I've also documented the script so people will know exactly
what's what when they write their own.

Here is what I've written so far:
http://drupal.org/node/115522#comment-281758

Two questions

   1. I couldn't figure out a good format to present the table I created
   that explains the relevant information for each attribute -- since forum
   comments don't allow tables. I presume that the nodes themselves allow table
   tags, yes? Any other ideas about how to present tabular information on a
   handbook page?
   2. The original example did not include setting the taxonomy hierarchy
   attribute and I can't figure out the syntax. Can someone help with that?


Thanks,

Shai
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20071017/2122ad76/attachment.htm