[IMP] base: improved doc for `states` attribute of fields

See #1527