[Sqlalchemy-tickets] Issue #3572: Ambiguous documentation about `bake_queries` param in `relationship` (zzzeek/sqlalchemy)

[Taha J. <iss...@bi...>]

New issue 3572: Ambiguous documentation about `bake_queries` param in `relationship`
https://bitbucket.org/zzzeek/sqlalchemy/issues/3572/ambiguous-documentation-about-bake_queries

Taha Jahangir:


Documentation about `bake_queries` param states that using baked queries in enabled by default  (1), but `orm.ext.baked` documentations says different. It seems `bake_queries` should be kept True, and `lazy` param should be set to `baked_select` to actually use baked queries. Also documentation of `lazy` param does not include the `baked_select` option.

[1] http://docs.sqlalchemy.org/en/rel_1_0/orm/relationship_api.html#sqlalchemy.orm.relationship.params.bake_queries

[2] http://docs.sqlalchemy.org/en/rel_1_0/orm/extensions/baked.html#lazy-loading-integration