updated docs with encoding info