add docs to readme, clean up inline doc