add request processing docs
fix javadoc typo
add TODOs to make handler chain exchangeable