The Netty documentation really is terrible. Have you read Netty In Action? That book made the framework much clearer.