Fix docs.
Optimization doc.
Improved README conversion.
Merge branch 'master' into surface