Fixed bad example in readme, improved docblocks for entityFactory().