added required fields to models
minor updates to descriptions of built-in fields