added comments to documentation
updated layout