docs(book): documentation for window rows vs range

[jangorecki]

• resolves TODO: example of rows vs range
• fix typo: row vs rows
• improves documentation as requested in window function could use local sort #3619: provide example of sort inside window

Possibly it is overly verbose, but it is better like that, so there is no space for misinterpretation.

[eitsupi]

Thanks for the contribution!
In my opinion, this new code block is evaluable, so I removed the no-eval tag.
And I ran tests and added the snapshot.

[jangorecki]

Yes code block is evaluable. I decided to not eval it because generated SQL doesn't really gives any more clarity over rows-vs-range, and due the to amount of lines it could possibly add more confusion, but I am fine either way.

[eitsupi]

Yes code block is evaluable. I decided to not eval it because generated SQL doesn't really gives any more clarity over rows-vs-range, and due the to amount of lines it could possibly add more confusion, but I am fine either way.

Yes, I understand the intent.
Perhaps the ideal here would be to be able to generate tables from prql code blocks using sqlite (or duckdb, I think the easiest way is to paste the Markdown output of duckdb CLI), but I think that would be a lot of work to try to implement in Rust.
(Of course, with knitr and prqlr this can be accomplished quickly, but that's the domain of https://github.com/eitsupi/querying-with-prql)

[jangorecki]

Ideally would be to have a spoiler button that shows SQL if desired. Anyway, I just pasted output from playground and formatted the same way as other tables are formatted in the book.

[max-sixty]

I think this is excellent! Thank you @jangorecki

FWIW I agree with @eitsupi that having the SQL there is useful. While it's a bit noisy in this case, since most of the documentation is about the behavior rather the translation, it limits how confused someone can get :)

[max-sixty]

Re having the results of queries in the book — #1895

[snth]

This is great! Thank you @jangorecki . ROWS vs RANGE is one of the most confusing things about window functions and SQL in general. When I try to recall my experience learning of learning this in SQL and the RDBMs docs I read at the time, they didn't make it that much clearer whereas this is an excellent example that explains it clearly! 🙏