Expanding the documentation on arbitrary scalar fields.

[cianwilson]

Also hopefully providing a framework for how we can implement custom reference states for them that I'd like to use as a discussion point.