docs: improve docstrings for as_scalar() and as_table()

Open NickCrews opened this issue 5 months ago • 2 comments

I tried to make these more beginner friendly. "Scalar subquery" is very overwhelming for someone coming from pandas, and I think should be treated as an implementation detail.

I tried to add more examples, to actually show WHY you would want to use this.

Sep 11 '25 17:09 NickCrews

@cpcloud Great suggestions, I accepted them, thanks!

Sep 30 '25 15:09 NickCrews

The two fixup commits I had to add here (because I thought we errored when doing bogus comparisons, but we don't actually error) to adjust the docstrings inspired me to write https://github.com/ibis-project/ibis/pull/11697

But that is a separate PR.

Oct 17 '25 01:10 NickCrews