text encoding + documentation