add many documentations, mainly on walk module, and fix examples to fit some modifications