Update docs

Author: ghostbuster91

modules/docs/markdown/02.1-serialisation/json.md

@@ -71,10 +71,19 @@ The options available through `JsoniterCodecCompiler` are:
 Changes the behaviour of the decoders so that they fail after a certain number of elements when decoding arrays and maps. 
 This allows to protect against some DDOS attacks.
 
-### withExplicitDefaultsEncoding
+## withFieldFilter
+
+**default**: FieldFilter.Default
+
+Changes the behaviour of Json encoders. Can be used to skip empty collections or unset optional fields to reduce the size of the final json.
+The default behavior skips unset optional fields or optional fields that have their value equal to the default value.
+
+### withExplicitDefaultsEncoding (deprecated)
 
 **default**: false
 
+This method is deprecated use `withFieldFilter` instead.
+
 Changes the behaviour of Json encoders so that optional values are encoded as
 explicit Json null values.
 

modules/docs/markdown/03-protocols/04-simple-rest-json/01-overview.md

@@ -60,31 +60,31 @@ structure Greeting {
 
 This protocol and its interpreters, are aware of the following traits provided out of the box:
 
-- [all simple shapes](https://awslabs.github.io/smithy/1.0/spec/core/model.html#simple-shapes)
-- composite data shapes, including collections, unions, structures.
-- [operations and services](https://awslabs.github.io/smithy/1.0/spec/core/model.html#service)
-- [enumerations](https://awslabs.github.io/smithy/1.0/spec/core/constraint-traits.html#enum-trait)
-- [error trait](https://awslabs.github.io/smithy/1.0/spec/core/type-refinement-traits.html#error-trait)
-- [http traits](https://awslabs.github.io/smithy/1.0/spec/core/http-traits.html)
-- [timestampFormat trait](https://awslabs.github.io/smithy/1.0/spec/core/protocol-traits.html?highlight=timestampformat#timestampformat-trait)
+* [all simple shapes](https://awslabs.github.io/smithy/1.0/spec/core/model.html#simple-shapes)
+* composite data shapes, including collections, unions, structures.
+* [operations and services](https://awslabs.github.io/smithy/1.0/spec/core/model.html#service)
+* [enumerations](https://awslabs.github.io/smithy/1.0/spec/core/constraint-traits.html#enum-trait)
+* [error trait](https://awslabs.github.io/smithy/1.0/spec/core/type-refinement-traits.html#error-trait)
+* [http traits](https://awslabs.github.io/smithy/1.0/spec/core/http-traits.html)
+* [timestampFormat trait](https://awslabs.github.io/smithy/1.0/spec/core/protocol-traits.html?highlight=timestampformat#timestampformat-trait)
 
 For the full list, see below.
 
 ## Decoding and encoding unions
 
 The `SimpleRestJson` protocol supports 3 different union encodings :
 
-- tagged (default)
-- untagged
-- discriminated
+* tagged (default)
+* untagged
+* discriminated
 
 See the section about [unions](../../04-codegen/02-unions.md) for a detailed description.
 
 ## Json Array Arity
 
-- By default there is a limit on the arity of an array, which is 1024. This is to prevent the server from being overloaded with a large array as this is a vector for attacks.
-- This limit can be changed by setting the maxArity `smithy4s.http4s.SimpleRestJsonBuilder.withMaxArity(.)` to the desired value.
-- an example can be seen in the [client example](03-client.md)
+* By default there is a limit on the arity of an array, which is 1024. This is to prevent the server from being overloaded with a large array as this is a vector for attacks.
+* This limit can be changed by setting the maxArity `smithy4s.http4s.SimpleRestJsonBuilder.withMaxArity(.)` to the desired value.
+* an example can be seen in the [client example](03-client.md)
 
 ## Field Filtering and Explicit Null Encoding