pg.ddx.io  pgsql-hackers@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Robert Haas <robertmhaas@gmail.com>
Cc: Amit Langote <Langote_Amit_f8@lab.ntt.co.jp>
Cc: Simon Riggs <simon@2ndquadrant.com>
Cc: Corey Huinker <corey.huinker@gmail.com>
Cc: Pg Hackers <pgsql-hackers@postgresql.org>
Subject: Re: Documentation improvements for partitioning
Date: Thu, 09 Mar 2017 14:37:53 -0500
Message-ID: <7256.1489088273@sss.pgh.pa.us> (raw)
In-Reply-To: <CA+TgmoaS=kSNAMP6LCx=3dZJvoH_K+5zv+qWK-tDqB-PAZ7d9A@mail.gmail.com>
References: <bf9ebbb3-fb1e-3206-b67c-e7a803a747d9@lab.ntt.co.jp>
	<CADkLM=esKK-DB=8fs6QNZZAa3N4-G9OuPQatAMSFPzmJv2HmPQ@mail.gmail.com>
	<89ebfd64-e32e-5a23-139e-0db816390091@lab.ntt.co.jp>
	<CANP8+jLkrdwjCRGgtepHFJFcwMFj9hX1mRG8=S+mSfB+sAuR1w@mail.gmail.com>
	<CA+TgmoYRBQh63vg+QK8QgZ312MBHaQ=mMs6UeLVPStRe2eJdNw@mail.gmail.com>
	<082fb36c-b5d4-eba3-1054-927946a49630@lab.ntt.co.jp>
	<CANP8+j+brBGyDqWv6YfWCQ3q3Am7py1XD+QpFsqVmTXbjtCbVg@mail.gmail.com>
	<60a484df-ed59-3f48-55be-5bdf3b3d2165@lab.ntt.co.jp>
	<CANP8+j+qrmiPF9Xu2rpUkOGts-B7iNJpXSvxCnEbeMQ729WW3Q@mail.gmail.com>
	<4eb8cfe4-b6c9-903d-4ce8-2a31fcee27e1@lab.ntt.co.jp>
	<CA+TgmoaS=kSNAMP6LCx=3dZJvoH_K+5zv+qWK-tDqB-PAZ7d9A@mail.gmail.com>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-hackers>

Robert Haas <robertmhaas@gmail.com> writes:
> This is about list-ifying a note, but I think we should try to
> de-note-ify it.  It's a giant block of text that is not obviously more
> noteworthy than the surrounding text; I think <note> should be saved
> for things that particularly need to be called out.

Yeah.  A big problem with the markup we use, imo, is that <note> segments
are displayed in a way that makes them more prominent than the surrounding
text, not less so.  That doesn't really square with my intuitive view of
what a <note> ought to be used for; it forces it to be considered as
something only slightly less dangerous than a <caution> or <warning>, not
as a parenthetical remark.  But that's what we have to deal with so
we should mark up our text accordingly.

			regards, tom lane


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



view thread (71+ messages)  latest in thread

Message-ID: <7256.1489088273@sss.pgh.pa.us>
Permalink:  ../7256.1489088273@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/7256.1489088273@sss.pgh.pa.us

 · 

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-hackers@postgresql.org
  Cc: tgl@sss.pgh.pa.us, robertmhaas@gmail.com, Langote_Amit_f8@lab.ntt.co.jp, simon@2ndquadrant.com, corey.huinker@gmail.com
  Subject: Re: Documentation improvements for partitioning
  In-Reply-To: <7256.1489088273@sss.pgh.pa.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox