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.