documented decoder pitfalls

to avoid mistakes found in https://github.com/netty/netty/issues/3184
I think this statement is not correct... it is ok to modify the reader index. Why you think it is not ?