update docs to include all possible error + examples