Add hwsim directory.
Add a bit more to the documentation. The most interesting piece is the
description of voting. Much more should be added.