documentation & better logs