gardening
update README with desired interface
update README: docs