watch API
updated docs and internals
updated README