cleanup and comments
updated README with functionality checklist