Doc review 8 26 2

@tthompson-okta @croche-okta @stsai-okta @srinivasanagandla-okta @lboyette-okta @wdawson-okta @hoanguyen-okta @karlmcguinness-okta @cwu-okta 

Mostly for Trevor--reset factors API doc.