docs & refactors