document update and fix broken build