documented decoder pitfalls

to avoid mistakes found in https://github.com/netty/netty/issues/3184
Add a sentence to explain that this is only an issue if you not add the returned ByteBuf to the List.