more changes to req doc based on jordan's feedback