document attributes functions

see: #1730
enforce controlled vocabulary for slot status

see: #1370
don't assume anything about slot status
Additional filtering on bogus values