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