Rocumented decoder pitfalls to avoid mistakes found in [#3184]