Some last refactoring to make the output of OCRmyPDF::run() more useful and added documentation in the README.

Signed-off-by: Misha Griffiths-Prasolova <misha@mishaprasolov.com>