[RFR] Fix readme example and remove documentation of deprecated APIs

Closes #196