not using deleted param atm, making type case insensitive
adding API docs to the README
Merge branch 'feature/docs' into dev