doc and req updates