[docs] HowToUpdateDebugInfo: Minor cleanups

• Change the reference to salvageDebugInfoOrUndef to salvageDebugInfo (in accordance with https://reviews.llvm.org/D78369).

• Reorganize a few sections in preparation for an upcoming change that attempts to specify rules for updating debug locations.

• Fix some intra-document links.

• Some spelling / wording fixes.