scalar() method is not documented

[Former user]

The .scalar() method on SQL results appears in a couple examples in the manual but is not explained. This is a very useful method and deserves documentation.

Usage: result.scalar() returns the first column in the first row if there is at least one row, otherwise it returns None.

[Mike Bayer]

it is documented in the generated module docs from its docstring. ResultProxy is generally not well documented in the external SA documentation, theres just some brief tutorial-style examples. im assuming you want it documented in the main docs, would you care to suggest documentation for ResultProxy overall that is more rigorous than the current example-oriented section ?

[Mike Bayer]

docs: http://www.sqlalchemy.org/docs/05/reference/sqlalchemy/connections.html?highlight=scalar#sqlalchemy.engine.base.ResultProxy.scalar

[Mike Bayer]

Removing milestone: 0.4.xx (automated comment)