Method Transformation feature

Author: raman-m

docs/features/methodtransformation.rst

@@ -1,23 +1,24 @@
-Method Transformation
-=====================
+Method Transformation [#f1]_
+============================
 
-Ocelot allows the user to change the HTTP request method that will be used when making a request to a downstream service.
-
-This achieved by setting the following Route configuration:
+Ocelot allows users to modify the HTTP request method used when making requests to a downstream service.
+This is achieved by setting the following route configuration:
 
 .. code-block:: json
 
   {
-    "UpstreamPathTemplate": "/{url}",
-    "DownstreamPathTemplate": "/{url}",
-    "DownstreamScheme": "http",
-    "DownstreamHostAndPorts": [
-      { "Host": "localhost", "Port": 54321 }
-    ],
-    "UpstreamHttpMethod": [ "Get" ],
-    "DownstreamHttpMethod": "POST" // !
+    "UpstreamPathTemplate": "/{everything}",
+    "DownstreamPathTemplate": "/{everything}",
+    // other props and opts...
+    "UpstreamHttpMethod": [ "Get" ], // we transform HTTP verb...
+    "DownstreamHttpMethod": "Post" // ...from GET to POST
   }
 
-The key property here is **DownstreamHttpMethod** which is set as ``POST`` and the Route will only match on ``GET`` as set by **UpstreamHttpMethod**.
+The key property here is ``DownstreamHttpMethod``, which is set to ``POST``, and the route will only match ``GET``, as specified by ``UpstreamHttpMethod``.
+
+This feature is useful when interacting with downstream APIs that only support ``POST`` while presenting a RESTful interface.
+
+""""
 
-This feature can be useful when interacting with downstream APIs that only support POST and you want to present some kind of RESTful interface.
+.. [#f1] This feature was released in version `14.0.8`_.
+.. _14.0.8: https://github.com/ThreeMammals/Ocelot/releases/tag/14.0.8