Documentation for (py)machinetalk/haltalk and its use is missing

[luminize]

For information regarding (py)machinetalk/haltalk I would need to dig thru the code. We should have (minimal is OK) documentation of it's design (minimal is ok) and how to use it.