Document enum datatype

[matthew-d-jones]

Document enum datatype added in #305.

[eugenwintersberger]

What exactly should be done here. The API documentation exists. Do we need some additional documentation in the users guide?

[matthew-d-jones]

Something in the user's guide or examples would be much more helpful.