Partitioning docs (was Re: Range partitioning and overlap)

[ redirecting to pgsql-docs ]

I wrote:
> Edson Richter <edsonrichter(at)hotmail(dot)com> writes:
>> Further on the documentation: "When creating a range partition, the lower bound specified with FROM is an inclusive bound, whereas the upper bound specified with TO is an exclusive bound."

>> I'm pretty sure I cannot find this statement in PostgreSQL 13 documentation page about partitioning. May be this statement is in another page?

> It's in the CREATE TABLE reference page. Seems like it would be a good
> idea to have it also in ddl.sgml's discussion of partitioning, though.

I went to do that, and soon decided that section 5.11 (Table Partitioning)
really could stand a fair amount of editorial attention. There's a lot
of less than pitch-perfect English, paragraphs that were evidently written
with only minimal attention to nearby existing material, diving into the
weedy details in even the earliest introductory paras, and so on. I
propose the attached.

regards, tom lane