Use a definition list for the incompatibilities

python-rapidjson · Aug 16, 2017 · 8605f6a · 8605f6a
1 parent 18fbbdc
commit 8605f6a
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 16 deletions.
diff --git a/README.rst b/README.rst
@@ -190,13 +190,14 @@ Incompatibility
 Here are things in the standard ``json`` library supports that we have decided
 not to support:
 
-* ``separators`` argument. This is mostly used for pretty printing and not
-  supported by ``RapidJSON`` so it isn't a high priority. We do support
-  ``indent`` kwarg that would get you nice looking JSON anyways.
-
-* Coercing keys when dumping. ``json`` will turn ``True`` into ``'True'`` if
-  you dump it out but when you load it back in it'll still be a string. We
-  want the dump and load to return the exact same objects so we have decided
-  not to do this coercing.
+``separators`` argument
+  This is mostly used for pretty printing and not supported by ``RapidJSON``
+  so it isn't a high priority. We do support ``indent`` kwarg that would get
+  you nice looking JSON anyways.
+
+Coercing keys when dumping
+  ``json`` will turn ``True`` into ``'True'`` if you dump it out but when you
+  load it back in it'll still be a string. We want the dump and load to return
+  the exact same objects so we have decided not to do this coercion.
 
 .. _RapidJSON: https://github.com/miloyip/rapidjson
diff --git a/docs/quickstart.rst b/docs/quickstart.rst
@@ -117,14 +117,15 @@ Incompatibilities
 Here are things in the standard ``json`` library that we have decided not to
 support:
 
-* ``separators`` argument. This is mostly used for pretty printing and not
-  supported by RapidJSON_ so it isn't a high priority. We do support
-  ``indent`` kwarg that would get you nice looking JSON anyways.
-
-* Coercing keys when dumping. ``json`` will turn ``True`` into ``'True'`` if
-  you dump it out but when you load it back in it'll still be a string. We
-  want the dump and load to return the exact same objects so we have decided
-  not to do this coercing.
+``separators`` argument
+  This is mostly used for pretty printing and not supported by RapidJSON_ so
+  it isn't a high priority. We do support ``indent`` kwarg that would get you
+  nice looking JSON anyways.
+
+Coercing keys when dumping
+  ``json`` will turn ``True`` into ``'True'`` if you dump it out but when you
+  load it back in it'll still be a string. We want the dump and load to return
+  the exact same objects so we have decided not to do this coercion.
 
 
 .. _JSON: http://json.org/