improved and fixed some errors in the documentation