many formatting changes and improved documentation
improved sample project
updated source submodule