add example with nil argument
document behavior with nested fields