minor correction in entities documentation
rewrite objects documentation