Re: Should we put command options in alphabetical order in the doc?

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com>
Cc: Peter Geoghegan <pg(at)bowt(dot)ie>, David Rowley <dgrowleyml(at)gmail(dot)com>, PostgreSQL Developers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Should we put command options in alphabetical order in the doc?
Date: 2023-04-19 09:07:04
Message-ID: 6D2F8F5C-50AA-4062-9D6A-20C6332E0AEA@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

> On 19 Apr 2023, at 10:52, Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com> wrote:

> For reference material, easy lookup should be a priority.

+1. Alphabetical ordering is consistent with POLA.

> For a narrative chapter on VACUUM, you can introduce the options in any other
> suitable order.

I would even phrase it such that in this case one *should* present the options
in the order most suitable to educate the reader.

--
Daniel Gustafsson

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Hayato Kuroda (Fujitsu) 2023-04-19 09:30:46 RE: Time delayed LR (WAS Re: logical replication restrictions)
Previous Message Peter Eisentraut 2023-04-19 08:52:06 Re: Should we put command options in alphabetical order in the doc?