Re: Wiki link for max_connections? (Fwd: Re: [ADMIN] PostgreSQL oom_adj postmaster process to -17)

On Thu, Aug 9, 2012 at 4:22 PM, Kevin Grittner
<Kevin(dot)Grittner(at)wicourts(dot)gov> wrote:
> [Forwarding to the -hackers list. Please respond there.]
>
> Craig Ringer <ringerc(at)ringerc(dot)id(dot)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/