[FAB-13327] Architecture Explained clarification

The Architecture Explained document is taken from the initial Fabric architectural proposal. This CR clarifies it as an Architecture Origin document that does not 100% represent Hyperledger Fabric as implemented. Change-Id: I4da44e053d55992458e8b7a292fd0f90c367ba49 Signed-off-by: David Enyeart <[email protected]> (cherry picked from commit 4fe73d2)
hyperledger · Dec 18, 2018 · 728f4eb · 728f4eb
1 parent cfdb44d
commit 728f4eb
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 4 deletions.
diff --git a/docs/source/arch-deep-dive.rst b/docs/source/arch-deep-dive.rst
@@ -1,5 +1,14 @@
-Architecture Explained
-======================
+Architecture Origins
+====================
+
+.. note :: This document represents the initial architectural proposal
+           for Hyperledger Fabric v1.0. While the Hyperledger Fabric
+           implementation has conceptually followed from the architectural
+           proposal, some details have been altered during the
+           implementation. The initial architectural proposal is
+           presented as originally prepared. For a more technically
+           accurate representation of the architecture, please see
+           `Hyperledger Fabric: A Distributed Operating System for Permissioned Blockchains <https://arxiv.org/abs/1801.10228v2>`__.
 
 The Hyperledger Fabric architecture delivers the following advantages:
 
@@ -33,7 +42,7 @@ v1**
 2. Basic workflow of transaction endorsement
 3. Endorsement policies
 
-   **Part II: Post-v1 elements of the architecture**
+**Part II: Post-v1 elements of the architecture**
 
 4. Ledger checkpointing (pruning)
 

diff --git a/docs/source/whatis.md b/docs/source/whatis.md
@@ -340,7 +340,7 @@ out-paces any of the other enterprise blockchain platforms.
 ## Acknowledgement
 
 The preceding is derived from the peer reviewed
-["Hyperledger Fabric: A Distributed Operating System for Permissioned Blockchains"](https://arxiv.org/abs/1801.10228v1) - Elli Androulaki, Artem
+["Hyperledger Fabric: A Distributed Operating System for Permissioned Blockchains"](https://arxiv.org/abs/1801.10228v2) - Elli Androulaki, Artem
 Barger, Vita Bortnikov, Christian Cachin, Konstantinos Christidis, Angelo De
 Caro, David Enyeart, Christopher Ferris, Gennady Laventman, Yacov Manevich,
 Srinivasan Muralidharan, Chet Murthy, Binh Nguyen, Manish Sethi, Gari Singh,