fix(sqla_factory): changed default value for __set_foreign_keys__ attr.

[nisemenov]

Description

• turned __set_foreign_keys__ attribute default value to False
• added an appropriate part of the docs

Prerequisites for this changing

Thanks to @adhtruong for #624 (comment)

... __set_foreign_keys__ is breaking behaviour.

and

Note a foreign key may be present without a relationship in ORM definition.

My intention would be:

• avoiding redundant factory work
  Although a foreign key can be used without a relationship, it is most often paired with a relationship. So a particular factory will be doing sort of a double work because creating foreign field data will be overridden by a relationship.

• consistency in the field logic with __set_relationships__ and __set_association_proxy__ (if the last one is added in the future)

Closes

• Closes feat(sqla_factory): added __set_association_proxy__ attribute #624

[github-actions]

Documentation preview will be available shortly at https://litestar-org.github.io/polyfactory-docs-preview/632