update encoder / decoder docs