Bug 715018 - Developer documentation on VBRs incorrect

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