Thanks! A year ago we were just two guys working on this project on the side without any funding. Now we're a full time team of talented devs swinging in full force. The comments and docs continue to improve, and we're excited that folks like yourself continue to take a look.
If you have more specific issues/comments/suggestions, please open an issue! https://github.com/tendermint/tendermint/issues