reads better
better docs
update netty tests to use newer server interfaces