Documentation comments

[glesica]

Documentation comments

It would be nice if every method and class had a concise explanation of how it fits into the overall architecture and what it can be expected to do… We won’t achieve this, but we can do our best with the parts of the code we understand well

We ought to leave behind some comments in the code to provide pointers for future AVX2 work