Jira issue originally created by user @beberlei:
We should remove UnitOfWork->flush() inside the Query class and document clearly the adverse effects that can happen.
Its much better peformance wise this way around and people shouldn't get into trouble.
Comment created by @beberlei:
Changed and noted in the new ReST branch of the docs that will go live before release.
Issue was closed with resolution "Fixed"