documentation for analysis developer and various refactorings