entities docs refactor