update/elaborate first blush of docs