doc updates (#15, #18)

reorganize table of contents
add warning about Request message version changes