docs: expanded on the validate_doc_update function

Here's an elaborated entry for the validate_doc_update function.  Most of the details were cribbed from the old wiki and the Guide, but feel free to correct or edit if I've gotten anything wrong.