needed changes; some docs, some follow-up to older bot changes

Change-Id: Ic81e249aa3c4453c71c885baf112cae6fe603986