add doc comments
better entity implementation that doesn't export HrefSelf() method