Doctrine is deprecating YAML support. As you said docblock annotations are treated as default. I would like to add that this is so true by a large margin. To the extend that using alternatives feels like an (undocumented) extra step. To clarify my previous statement: I like annotations. I just don't like how a large part of the community is forced into the docblock hack.