some wordsmithing and doc work