added documentation for entity creation