WIP 20250517-1144

Author: jechol

README.md

@@ -43,11 +43,11 @@ Post.random_params!(:create, %{author: "James"}, %{
 
 ### Options
 
-By default, it generates attributes and arguments except those with `allow_nil?: true`.
+By default, it generates random values for attributes and arguments that have `allow_nil?: false` and no default value (`default == nil`).
 
-- `populate`: Generates values even for attributes/arguments with `allow_nil?: true`
-- `omit`: Skips generation even for attributes/arguments with `allow_nil?: false`
-- `include_defaults?`: When set to `true`, includes default values for attributes/arguments with `allow_nil?: true`
+- `populate`: Forces generation of random values for specified attributes/arguments, overriding the default behavior
+- `omit`: Prevents generation of random values for specified attributes/arguments, overriding the default behavior
+- `include_defaults?`: When set to `true`, includes default values for attributes/arguments that have either `allow_nil?: true` or a non-nil default value. Defaults to `true`.
 
 ### Custom Random Generator