README: add some doc on the methods