Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bTfep-00085Q-Ml for pgsql-docs@arkaria.postgresql.org; Sun, 31 Jul 2016 01:35:11 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.84_2) (envelope-from ) id 1bTfep-0006SC-9R for pgsql-docs@arkaria.postgresql.org; Sun, 31 Jul 2016 01:35:11 +0000 Received: from makus.postgresql.org ([2001:4800:1501:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1bTfeT-0005ql-05 for pgsql-docs@postgresql.org; Sun, 31 Jul 2016 01:34:49 +0000 Received: from momjian.us ([72.94.173.45]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.84_2) (envelope-from ) id 1bTfeL-0005rd-Hw for pgsql-docs@postgresql.org; Sun, 31 Jul 2016 01:34:47 +0000 Received: from bruce by momjian.us with local (Exim 4.84_2) (envelope-from ) id 1bTfeJ-0005ld-7i; Sat, 30 Jul 2016 21:34:39 -0400 Date: Sat, 30 Jul 2016 21:34:39 -0400 From: Bruce Momjian To: Daniel Gustafsson Cc: pgsql-docs@postgresql.org Subject: Re: Wording in Error Message Style Guide Message-ID: <20160731013439.GJ22405@momjian.us> References: <48DB4EDA-96F8-4B2F-99C4-110900FC7540@yesql.se> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <48DB4EDA-96F8-4B2F-99C4-110900FC7540@yesql.se> User-Agent: Mutt/1.5.23 (2014-03-12) X-Pg-Spam-Score: -3.2 (---) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org On Fri, Jul 15, 2016 at 11:20:27AM +0200, Daniel Gustafsson wrote: > Perhaps a nitpick, but in subsection 51.3.1 in the "Error Message Style Guide" > the language in the rationale for avoiding implementation details seems to not > be in line with the overall one of voice of the docs. ISTM the following reads > better: > > - don't know the details anyway. > + aren't expected to know the details. > > Patch attached. Thanks, patch applied. -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + As you are, so once was I. As I am, so you will be. + + Ancient Roman grave inscription + -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs