Re: 5.12.2.1. Example

On Fri, 23 Oct 2026 at 21:45, Daniel Gustafsson <daniel(at)yesql(dot)se> wrote:
>
> > On 23 Oct 2026, at 10:33, David Rowley <dgrowleyml(at)gmail(dot)com> wrote:
> > -- plus y2006m04 .. y2007m10 (abbreviation for brevity)
>
> Or perhaps "-- repeated for y2006m04 .. y2007m10 (abbreviated for brevity)"

or "repeat", as in, we're asking them to do it.

> If someone copy pastes the entire block I fear that they think it's a complete
> example, and when it isn't then perhaps getting a syntax error is better?

I think as long as there are no errors to say table yNNNNmNN does not
exist between all the example there, it's probably fine. I do see the
trigger function example doesn't contain all the tables that were
created, but I think that's fine. Making that example longer to fix
that wouldn't make it any more readable. I don't think we promise
fully working examples. IMO, they're aimed to be a guide for learning.

> That being said, replacing "..." is a good idea regardless of being a comment
> or not, your suggestion makes the docs more readable,

I'm happy to review a patch.

David