Hi, I've added a patch under PDFBOX-661 implementing some of the changes to the documentation for your review. Please let me know if the changes are inline with your thoughts. If they are I'll move forward completing the task.
Kind regards Maruan Sahyoun