update comments
first step toward using mkdocs and markdown documentation