Preliminary improvements to documentation, esp internal types e.g. Units

Preliminary improvements to documentation, esp internal types e.g. Units #930