Documentation possible errors and fix