updates to source files and documents layout