tiny doc fixes
allow definition of required item attributes