extended documentation on common problems and solutions
typos and omissions