add new watch event type
convert etcd errors to watch errors
update pkg/api documentation
handle watch errors everywhere
Merge pull request #1404 from lavalamp/scheduler

Add error type to watch.