Some improvements to the HEK documentation

Apologies if the formatting is wrong.  I have given brief descriptions of some of the major parts of the HEK code base and how it is constructed.