so we need new SonataBlockBundle as well? ok, i think you proved your point that we better link to the other doc :-)

can you then simply change the comment line to say something like

    // ...
    // set up basic sonata requirements
    // ...

and do a `.. note::` block saying to first do the generic sonata init things? i am afraid of the user not noticing he needs to do more.