Update docs to reference both ways of returning entities

Closes josegonzalez/josegonzalez.github.io#3