[FAB-13021] What's new in v1.4

Rundown of new features and doc.

Change-Id: I86bbb632c54b7dc197dd40423a04701e63698976
Signed-off-by: joe-alewine <Joe.Alewine@ibm.com>

Author: joe-alewine

docs/source/whatsnew.rst

@@ -1,65 +1,124 @@
-What's new in v1.3
+What's new in v1.4
 ==================
 
-A quick rundown of the new features and documentation in the v1.3 release of
-Hyperledger Fabric:
+Hyperledger Fabric has matured since the initial v1.0 release, and so has the
+community of Fabric operators and developers. The Fabric developers have been
+working with network operators and application developers to deliver v1.4 with
+a focus on production operations and developer ease of use. The two major
+release themes for Hyperledger Fabric v1.4 revolve around these two areas:
 
-New features
-------------
+* **Serviceability and Operations**: As more Hyperledger Fabric networks get
+  deployed and enter a production state, serviceability and operational aspects
+  are critical. Fabric v1.4 takes a giant leap forward with logging improvements,
+  health checks, and operational metrics. Along with a focus on stability
+  and fixes, Fabric v1.4 is the recommended release for production operations.
+  Future fixes will be delivered on the v1.4.x stream, while new features are
+  being developed in the v2.0 stream.
 
-* :doc:`idemix`:
-  A way to keep identities anonymous and unlinkable through the use of zero-knowledge
-  proofs. There is a tool that can generate Identity Mixer credentials in test
-  environments known as `idexmigen`, the documentation for which can be found in
-  :doc:`idemixgen`.
+* **Improved programming model for developing applications**: Writing
+  decentralized applications has just gotten easier. Programming model
+  improvements in the Node.js SDK and Node.js chaincode makes the development
+  of decentralized applications more intuitive, allowing you to focus
+  on your application logic. The existing npm packages are still available for
+  use, while the new npm packages provide a layer of abstraction to improve
+  developer productivity and ease of use.
 
-* :ref:`key-level-endorsement`:
-  Allows the default chaincode-level endorsement policy to be overridden by a
-  per-key endorsement policy.
+Serviceability and operations improvements
+------------------------------------------
 
-* :ref:`cdb-pagination`:
-  Clients can now page through result sets from chaincode queries, making it
-  feasible to support large result sets with high performance.
+* :doc:`operations_service`:
+  The new RESTful operations service provides operators with three
+  services to monitor and manage peer and orderer node operations:
 
-* :doc:`chaincode4ade`:
-  As an addition to the current Fabric support for chaincode written in Go and
-  node.js, Java is now supported. You can find a javadoc for this
-  `here <https://fabric-chaincode-java.github.io/>`__.
+  * The logging ``/logspec`` endpoint allows operators to dynamically get and set
+    logging levels for the peer and orderer nodes.
 
-* :doc:`peer_event_services`:
-  The peer channel-based event service itself is not new (it first debuted in v1.1),
-  but the v1.3 release marks the end of the old event hub. Applications using
-  the old event hub must switch over to the new peer channel-based event service prior to
-  upgrading to v1.3.
+  * The ``/healthz`` endpoint allows operators and container orchestration services to
+    check peer and orderer node liveness and health.
+
+  * The ``/metrics`` endpoint allows operators to utilize Prometheus to pull operational
+    metrics from peer and orderer nodes. Metrics can also be pushed to StatsD.
+
+Improved programming model for developing applications
+------------------------------------------------------
+
+The new Node.js SDK and chaincode programming model makes developing decentralized
+applications easier and improves developer productivity. New documentation helps you
+understand the various aspects of creating a decentralized application for
+Hyperledger Fabric, using a commercial paper business network scenario.
+
+* :doc:`developapps/scenario`:
+  Describes a hypothetical business network involving six organizations who want
+  to build an application to transact together that will serve as a use case
+  to describe the programming model.
+
+* :doc:`developapps/analysis`:
+  Describes the structure of a commercial paper and how transactions affect it
+  over time. Demonstrates that modeling using states and transactions
+  provides a precise way to understand and model the decentralized business process.
+
+* :doc:`developapps/architecture`:
+  Shows how to design the commercial paper processes and their related data
+  structures.
+
+* :doc:`developapps/smartcontract`:
+  Shows how a smart contract governing the decentralized business process of
+  issuing, buying and redeeming commercial paper should be designed.
+
+* :doc:`developapps/application`
+  Conceptually describes a client application that would leverage the smart contract
+  described in :doc:`developapps/smartcontract`.
+
+* :doc:`developapps/designelements`:
+  Describes the details around contract namespaces, transaction context,
+  transaction handlers, connection profiles, connection options, wallets, and
+  gateways.
+
+And finally, a tutorial and sample that brings the commercial paper scenario to life:
+
+* :doc:`tutorial/commercial_paper`
 
 New tutorials
 -------------
 
+* :doc:`write_first_app`:
+  This tutorial has been updated to leverage the improved Node.js SDK and chaincode
+  programming model. The tutorial has both JavaScript and Typescript examples of
+  the client application and chaincode.
+
+* :doc:`tutorial/commercial_paper`
+  As mentioned above, this is the tutorial that accompanies the new Developing
+  Applications documentation.
+
 * :doc:`upgrade_to_newest_version`:
-  Leverages the BYFN network to show how an upgrade flow should work. Includes
-  both a script (which can serve as a template for upgrades), as well as the
-  individual commands.
+  Leverages the network from :doc:`build_network` to demonstrate an upgrade from
+  v1.3 to v1.4. Includes both a script (which can serve as a template for upgrades),
+  as well as the individual commands so that you can understand every step of an
+  upgrade.
+
+Private data enhancements
+-------------------------
 
-* :ref:`cdb-pagination`:
-  Expands the current CouchDB tutorial to add pagination.
+* :doc:`private-data-arch`:
+  The Private data feature has been a part of Fabric since v1.2, and this release
+  debuts two new enhancements:
 
-Other new documentation
------------------------
+  * **Reconciliation**, which allows peers for organizations that are added
+    to private data collections to retrieve the private data for prior
+    transactions to which they now are entitled.
 
-* :doc:`network/network`:
-  Conceptual documentation that shows how the parts of a network interact with
-  each other. The initial version of this document was added in v1.2.
+  * **Client access control** to automatically enforce access control within
+    chaincode based on the client organization collection membership without having
+    to write specific chaincode logic.
 
 Release notes
 =============
 
-For more information, including `FAB` numbers for the issues and code reviews
-that made up these changes (in addition to other hygiene/performance/bug fixes
-we did not explicitly document), check out the release notes. Note that these
-links will not work on the release candidate, only on the GA release.
+The release notes provide more details for users moving to the new release, along
+with a link to the full release change log.
 
-* `Fabric release notes <https://github.com/hyperledger/fabric/releases/tag/v1.3.0>`_.
-* `Fabric CA release notes <https://github.com/hyperledger/fabric-ca/releases/tag/v1.3.0>`_.
+* `Fabric release notes <https://github.com/hyperledger/fabric/releases/tag/v1.4.0>`_.
+* `Fabric CA release notes <https://github.com/hyperledger/fabric-ca/releases/tag/v1.4.0>`_.
 
 .. Licensed under Creative Commons Attribution 4.0 International License
    https://creativecommons.org/licenses/by/4.0/