improve clarity

reorganize directory structure, and update documentation