fixed deletion, documented watches and updated readme
markdown barfed when run gainst full HTML docs. Not worth fixing