fix regressions
documentation of project structure