Peter,

> If you plan to do major outline reorganizations, I suggest that you do
> them somewhat sooner than a few days before release, because there is
> also a release management effort involved in the documentation.  But
> you can always plug in your latest measurements any time.

No massive re-org, we did that last version.

No, here's what I want to do:

1) add a new section at the top of the docs describing the most common options 
that people want to set on a new installation.
2) Add notes to each item about how to decide what to set it at.
3) Add label/values for:
        Default Value:
        Set At: (when you can change it)
        (this latter information is there but buried in the text; it would be better   
 
        put on a seperate line)
4) add notes regarding version changes (like that work_mem used to be 
sort_mem, and that add_missing_from will default to "false" next version)

Your recommendations on tagging stuff are highly welcome; I'm still 
uncomfortable with SGML.

-- 
Josh Berkus
Aglio Database Solutions
San Francisco

---------------------------(end of broadcast)---------------------------
TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]

Reply via email to