clean up docs and fix the dot support