1. Entities => Documents

2. In the annotations reference I delimted options with emphasis like

- **persist** - Cascade persist operations to the associated entities.

Which I think I copied from the sf docs for stuff like that, e.g. http://symfony.com/doc/current/book/templating.html#template-suffix

I think I have also seen two backquotes being used to delimt the "option" in definition lists like this, but maybe that applies more to class names etc. Is there are style guide that covers stuff like this?