More docs

1 files changed, 7 insertions, 5 deletions

diff --git a/docs/json.rst b/docs/json.rst
index 086fa60..032c120 100644
--- a/docs/json.rst
+++ b/docs/json.rst
@@ -3,14 +3,16 @@
 JSON
 ====
 
-JSON encoding of bodies and decoding of responses can be handled using 
-`Circe <https://circe.github.io/circe/>`_ by the ``circe`` module. To use
-add the following dependency to your project::
+Adding support for JSON (or other format) bodies in requests/responses is a matter of providing a :ref:`body serializer <requestbody_custom>` and/or a :ref:`response body specification <responsebodyspec_custom>`. Both are quite straightforward to implement, so integrating with your favorite JSON library shouldn't be a problem. However, there are some integrations available out-of-the-box.
+
+Circe
+-----
+
+JSON encoding of bodies and decoding of responses can be handled using `Circe <https://circe.github.io/circe/>`_ by the ``circe`` module. To use add the following dependency to your project::
 
   "com.softwaremill.sttp" %% "circe" % "0.0.20"
 
-This module adds a method to the request and a function that can be given to
-a request to decode the response to a specific object::
+This module adds a method to the request and a function that can be given to a request to decode the response to a specific object::
 
   import com.softwaremill.sttp._
   import com.softwaremill.sttp.circe._