add the `lenient` option to field_value_factor
Add documentation for field_value_factor
randomly pick a numeric type for the test
add failing test demonstrating null .failure() issue
add javadoc