Update readability in entities docs