Improve Fields Documentation.

I am planning to add example to all fields, but what do you think so far?
indentation under type or no ?