Yeah, I am still rewriting this so will try and make it clear how it
works. For me the `end()` thing is a necessary evil, but if we can drop
it when we don't need it all the better. Initially I wanted to not have
it at all, and make the QueryBuilder auto-magically make sense of
itself, but I don't think that was possible.

Maybe I should make it clear that it is only required when you want to
extend the chain beyond the last factory.

On Wed, Sep 18, 2013 at 01:01:09PM -0700, David Buchmann wrote:
>    In en/reference/query-builder-2.rst:
> 
>  > +The third line says that we want only documents where the value of the
>  > +field "name" from the selector named "u" is equal (eq) to the
>  > +literal string "dtl".
>  > +
>  > +The forth and final line retrieves the :ref:`query <queryref>` object.
>  > +
>  > +Alternatively the above query can be written more fluently by the using
>  > +``end()`` terminators as follows:
>  > +
>  > +.. code-block:: php
>  > +
>  > +    <?php
>  > +    $qb = $documentManager->createQueryBuilder();
>  > +    $qb->from()
>  > +        ->document('Blog\User')
>  > +      ->end()
> 
>    okay, i won't insist anymore. lets see if it works this way, we can
>    alsways improve later when we get reader feedback ;-)
> 
>    —
>    Reply to this email directly or [1]view it on GitHub.
> 
> References
> 
>    Visible links
>    1. https://github.com/doctrine/phpcr-odm-documentation/pull/33/files#r6444684