cleans up code
adds info to markdown doc