On Thu, Dec 17, 2020 at 7:42 AM Bruce Momjian <br...@momjian.us> wrote: > I agree a holistic review of the docs can yield great benefits. No one > usually complains about overly verbose text, but making it clearer is > always a win. Anyway, of course, it is going to be very specific for > each case. As an extreme example, in 2007 when I did a full review of > the docs, I clarified may/can/might in our docs, and it probably helped.
I think that the "may/can/might" rule is a very good one. It standardizes something that would otherwise just be left to chance, and AFAICT has no possible downside. Even still, I think that adding new rules is subject to sharp diminishing returns. There just aren't that many things that work like that. -- Peter Geoghegan
