another pass at docs