raft: add a doc.go file

Explain the package from a high level.
raft: add useful comments

These comments were things I learned about the units, use case or
meaning of various fields and functions in the raft package.
Merge pull request #1066 from philips/add-raft-doc

add-raft-doc