added more documentation to Entity