docs and MOAAARRR refactoring