Address code review comments

- update md file based on Rmd
- also up description number
- fix todo in test file