OGM-683 Minor fixes in documentation

  * Replace "Builtin" with "Built-in" for consistency
  * Replace "in-entity" with "in entity" for consistency
  * Typos and minor fixes
OGM-603 OGM-516 Add API chapter and clarify what is supported and not
OGM-683 Further documentation improvements