various changes to req doc based on jme's feedback