update docs, document each field type in detail