worked on #17. Complete docblocks for the engine.entity namespace