Improve README

and add utf-8 flag to doc generation