improved documentation of restrictions