ensured source files were well commented