hc: First cut at API docs
hc: First cut at API docs

These are kind of dumb/ambiguous, and I probably need to write a decent
user-facing doc before I can come up with proper detailed API docs.  But
they're enough to give some context and make it easier to read the code
(I hope).

josh-berry/homectl,josh-berry/homectl