various fixes to docs

Change Id: 22afc7f619260a57a847a9495be6ec52637cf801