first revision of docs. Errors moved into one file to simplify representation