Add documentation for enums

[gordonwatts]

We now have enum support. Need to demonstrate it

• When you return enum
• When you pass enum's to a method.

Our work on CalRatio training data should show off the latter - so copy that!?