Do NOT MERGE: Doc updates; intermediate checkin

This pr is for ongoing discussion and review.