On Thu, Aug 9, 2012 at 4:22 PM, Kevin Grittner
<kevin.gritt...@wicourts.gov> wrote:
> [Forwarding to the -hackers list.  Please respond there.]
>
> Craig Ringer <ring...@ringerc.id.au> wrote:
>> On 08/09/2012 04:24 AM, Kevin Grittner wrote:
>>> http://wiki.postgresql.org/wiki/Number_Of_Database_Connections
>>>
>> Can we please please PLEASE link to that as a comment above
>> max_connections?
>>
>> Last time this came up nobody was happy with wording of a comment
>> so nothing got done. It's a real usability wart - causing
>> real-world performance and reliability problems - that people
>> unwittingly raise max_connections to absurd levels because they
>> get no warnings, hints or guidance of any sort.
>
> I see that we currently have five links to wiki.postgresql.org in
> release notes and four more in the rest of the docs.  Are people OK
> with adding this link to the docs on max_connections?  (Feel free to
> improve it before answering if you have qualms about the specifics
> on that page.)

I think we should do that in the cases where the text is "volatile",
such as when it refers to external products or things that are likely
to change. I think this one qualifies reasonably well.

However, I wonder if we should somehow try to keep track of those that
*are* linked from the documentation. I assume you just grep:ed this
time, or something like that? Perhaps we should assign all such pages
a specific category or so on the wiki, so we can police them a bit
extra hard?


-- 
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/

-- 
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

Reply via email to