fix encoding comments
rewrite docs