Bug 715018 - Developer documentation on VBRs incorrect

Fix the order of fields, and improve some other parts.

(cherry picked from commit a7e9016f11cc91eb1c71c68354f3747fc2e5a8b1)