more detailed documentation and error debugging file