Update Contract and Application API docs for Fabric Gateway (#3048)

Signed-off-by: Mark S. Lewis <mark_lewis@uk.ibm.com>
hyperledger · Nov 16, 2021 · 8a4c7f3 · 8a4c7f3
1 parent 91d7b7c
commit 8a4c7f3
Showing 1 changed file with 7 additions and 6 deletions.
diff --git a/docs/source/sdk_chaincode.md b/docs/source/sdk_chaincode.md
@@ -1,4 +1,4 @@
-# Fabric Contract APIs and Application SDKs
+# Fabric Contract APIs and Application APIs
 
 ## Fabric Contract APIs
 
@@ -9,10 +9,13 @@ Smart contract APIs are available for Go, Node.js, and Java.
 * [Node.js contract API](https://github.com/hyperledger/fabric-chaincode-node) and [documentation](https://hyperledger.github.io/fabric-chaincode-node/).
 * [Java contract API](https://github.com/hyperledger/fabric-chaincode-java) and [documentation](https://hyperledger.github.io/fabric-chaincode-java/).
 
-## Fabric Application SDKs
+## Fabric Application APIs
 
-Hyperledger Fabric offers a number of SDKs to support developing applications in various programming languages.
-SDKs are available for Node.js, Java, and Go:
+Hyperledger Fabric offers a Fabric Gateway application API to support developing applications in Go, Node.js, and Java. This API uses the Gateway peer capability introduced in Fabric v2.4 to interact with the Fabric network, and is an evolution of the new application programming model introduced in Fabric v1.4. The Fabric Gateway API is the preferred API for developing applications for Fabric v2.4 onwards.
+
+* [Fabric Gateway application API](https://github.com/hyperledger/fabric-gateway) and [documentation](https://hyperledger.github.io/fabric-gateway/).
+
+Legacy application SDKs also exist for various programming languages, and can be used with Fabric v2.4. These application SDKs support versions of Fabric prior to v2.4, and do not require the Gateway peer capability. They also include some functionality, such as administrative actions for managing enrollment of identities with a Certificate Authority (CA), that are not offered by the Fabric Gateway API. Application SDKs are available for Go, Node.js and Java.
 
 * [Node.js SDK](https://github.com/hyperledger/fabric-sdk-node) and [documentation](https://hyperledger.github.io/fabric-sdk-node/).
 * [Java SDK](https://github.com/hyperledger/fabric-gateway-java) and [documentation](https://hyperledger.github.io/fabric-gateway-java/).
@@ -27,5 +30,3 @@ In addition, there is one other application SDK that has not yet been
 officially released for Python, but is still available for downloading and testing:
 
 * [Python SDK](https://github.com/hyperledger/fabric-sdk-py).
-
-Currently, Node.js, Java and Go support the new application programming model delivered in Hyperledger Fabric v1.4.