update readme
better start to API work

new functions inserted but commented out as they still need to be
created.