richards tests and user doco added.  partially addresses ticked #2637
richards theory doco added.  Completes ticket #2637
Merge pull request #2638 from WilkAndy/feature_2637

Merging documentation #2637
Merge commit '8a969202dace2cf3ee2945f4bf79281f92f9e47d'