added comments and markdown