diff --git a/docs/api-guide/fields.md b/docs/api-guide/fields.md index 78fb3f83e..69a769c79 100644 --- a/docs/api-guide/fields.md +++ b/docs/api-guide/fields.md @@ -41,14 +41,6 @@ Setting this to `False` also allows the object attribute or dictionary key to be Defaults to `True`. -### `allow_null` - -Normally an error will be raised if `None` is passed to a serializer field. Set this keyword argument to `True` if `None` should be considered a valid value. - -Note that setting this argument to `True` will imply a default value of `null` for serialization output, but does not imply a default for input deserialization. - -Defaults to `False` - ### `default` If set, this gives the default value that will be used for the field if no input value is supplied. If not set the default behaviour is to not populate the attribute at all. @@ -61,6 +53,14 @@ When serializing the instance, default will be used if the the object attribute Note that setting a `default` value implies that the field is not required. Including both the `default` and `required` keyword arguments is invalid and will raise an error. +### `allow_null` + +Normally an error will be raised if `None` is passed to a serializer field. Set this keyword argument to `True` if `None` should be considered a valid value. + +Note that setting this argument to `True` will imply a default value of `null` for serialization output, but does not imply a default for input deserialization. + +Defaults to `False` + ### `source` The name of the attribute that will be used to populate the field. May be a method that only takes a `self` argument, such as `URLField(source='get_absolute_url')`, or may use dotted notation to traverse attributes, such as `EmailField(source='user.email')`. When serializing fields with dotted notation, it may be necessary to provide a `default` value if any object is not present or is empty during attribute traversal.