introduced entity package, numerous updates in documentation