update encoder parsing and docs