polyroots: Improve documentation

We did few changes here and there and added a new section about how the
precision works.