change log:

1. Add article to README.md and notebook
2. Add flowchart to notebook

Author: Wasin Waeosri

README.md

@@ -8,6 +8,8 @@
 
 This example shows how to writing the [Elektron WebSocket API](https://developers.refinitiv.com/elektron/websocket-api) application to subscribe Machine Readable News (MRN) from Thomson Reuters Enterprise Platform (TREP). The example just connects to TREP via a WebSocket connection, then subscribes and display MRN News data in a console or classic Jupyter Notebook. The project are implemented with Python language for both console and Jupyter Notebook applications, but the main concept for consuming and assembling MRN News messages are the same for all technologies. 
 
+Please see a full documentation of this example application in [this article](https://developers.refinitiv.com/article/introduction-machine-readable-news-elektron-websocket-api-refinitiv).
+
 *Note:* The news message is in UTF-8 JSON string format. Some news messages that contains special unicode character may not be able to show in Windows OS console (cmd, git bash, powershell, etc) due to the OS limitation. Those messages will be print as ```UnicodeEncodeError exception. Cannot decode unicode character``` message in a console instead.
 
 ## Machine Readable News Overview
@@ -28,7 +30,7 @@ The data goes through the following series of transformations:
 3. The compressed JSON is split into a number of fragments (BUFFER or Base64 ascii string) which each fit into a single update message
 4. The data fragments are added to an update message as the FRAGMENT field value in a FieldList envelope
 
-Therefore, in order to parse the core content data, the application will need to reverse this process. The WebSocket application also need to convert a received Base64 string in a FRAGMENT field to bytes data before further process this field. This application uses Python [base64](https://docs.python.org/3/library/base64.html) and [zlib](https://docs.python.org/3/library/zlib.html) modules to decode Base64 string and decompress JSON string.
+Therefore, in order to parse the core content data, the application will need to reverse this process. The WebSocket application also need to convert a received Base64 string in a FRAGMENT field to bytes data before further process this field. This application uses Python [base64](https://docs.python.org/3/library/base64.html) and [zlib](https://docs.python.org/3/library/zlib.html) modules to decode Base64 string and decompress JSON string. 
 
 If you are not familiar with MRN concept, please visit the following resources which will give you a full explanation of the MRN data model and implementation logic:
 * [Webinar Recording: Introduction to Machine Readable News](https://developers.refinitiv.com/news#news-accordion-nid-12045)
@@ -189,6 +191,7 @@ News = {'altId': 'nIdw5d8Hwd', 'audiences': ['NP:CNRA', 'NP:IDXN'], 'body': 'Lap
 * [Refinitiv Elektron SDK Family page](https://developers.refinitiv.com/elektron) on the [Refinitiv Developer Community](https://developers.thomsonreuters.com/) web site.
 * [Refinitiv Elektron WebSocket API page](https://developers.refinitiv.com/websocket-api).
 * [Developer Webinar Recording: Introduction to Electron WebSocket API](https://www.youtube.com/watch?v=CDKWMsIQfaw).
+* [Introduction to Machine Readable News with Elektron WebSocket API](https://developers.refinitiv.com/article/introduction-machine-readable-news-elektron-websocket-api-refinitiv).
 * [Machine Readable News (MRN) & N2_UBMS Comparison and Migration Guide](https://developers.refinitiv.com/article/machine-readable-news-mrn-n2_ubms-comparison-and-migration-guide).
 * [Introduction to Machine Readable News (MRN) with Elektron Message API (EMA)](https://developers.refinitiv.com/article/introduction-machine-readable-news-mrn-elektron-message-api-ema).
 * [MRN Data Models and Elektron Implementation Guide](https://developers.refinitiv.com/elektron/elektron-sdk-java/docs?content=8736&type=documentation_item).

notebook/images/mrn_flowchart.png

@@ -52,6 +52,8 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
+    "Please see a full documentation of this example application in [this article](https://developers.refinitiv.com/article/introduction-machine-readable-news-elektron-websocket-api-refinitiv).\n",
+    "\n",
     "If you are not familiar with MRN concept, please visit the following resources which will give you a full explanation of the MRN data model and implementation logic:\n",
     "* [Webinar Recording: Introduction to Machine Readable News](https://developers.refinitiv.com/news#news-accordion-nid-12045)\n",
     "* [Introduction to Machine Readable News (MRN) with Elektron Message API (EMA)](https://developers.refinitiv.com/article/introduction-machine-readable-news-mrn-elektron-message-api-ema).\n",
@@ -197,19 +199,8 @@
     "The subsequent update contains the fields necessary to identify the MRN data item, the order of this fragment among all the fragments for this item, and the fragment itself. The other point to note is that (for a Multi fragment item), Update messages with FRAG_NUM >1 will have fewer FIDs as the metadata is included in the first Update message (FRAG_NUM=1) for that item\n",
     "\n",
     "#### News Fragments simple handle logic\n",
-    "1. Check if incoming message FRAG_NUM value =1\n",
-    "2. If yes, this message is the first update message\n",
-    "    * convert FRAGMENT value from Base64 ascii string to bytes value with [base64](https://docs.python.org/3/library/base64.html) module\n",
-    "    * if FRAGMENT bytes length equal to TOT_SIZE value, it means this is a single fragment news. \n",
-    "        * The application uses [zlib](https://docs.python.org/3/library/zlib.html) module to unzip the FRAGMENT bytes value to JSON string\n",
-    "    * if not, it means this message is a first fragment of multiple fragments news. \n",
-    "        * The application then keeps news update data in dictionary object with GUID as a key.\n",
-    "3. If FRAG_NUM value > 1, it means this is a subsequent Update message for multiple fragments news\n",
-    "    * get associate news data (previous multi-fragments) from GUID\n",
-    "    * convert FRAGMENT value from Base64 ascii string to bytes value and add it to current multi-fragments\n",
-    "    * if this multi-fragments bytes length equal to TOT_SIZE value, it means this news fragment is completed and all fragments have been received. \n",
-    "        * The application unzip this multi-fragments bytes value to JSON string\n",
-    "    * if not, the application continue wating for more fragments from furthure update for the same GUID\n"
+    "\n",
+    "![title](./images/mrn_flowchart.png)\n"
    ]
   },
   {
@@ -2153,6 +2144,7 @@
     "* [Refinitiv Elektron SDK Family page](https://developers.refinitiv.com/elektron) on the [Refinitiv Developer Community](https://developers.thomsonreuters.com/) web site.\n",
     "* [Refinitiv Elektron WebSocket API page](https://developers.refinitiv.com/websocket-api).\n",
     "* [Developer Webinar Recording: Introduction to Electron WebSocket API](https://www.youtube.com/watch?v=CDKWMsIQfaw).\n",
+    "* [Introduction to Machine Readable News with Elektron WebSocket API](https://developers.refinitiv.com/article/introduction-machine-readable-news-elektron-websocket-api-refinitiv).\n",
     "* [Machine Readable News (MRN) & N2_UBMS Comparison and Migration Guide](https://developers.refinitiv.com/article/machine-readable-news-mrn-n2_ubms-comparison-and-migration-guide).\n",
     "* [Introduction to Machine Readable News (MRN) with Elektron Message API (EMA)](https://developers.refinitiv.com/article/introduction-machine-readable-news-mrn-elektron-message-api-ema).\n",
     "* [MRN Data Models and Elektron Implementation Guide](https://developers.refinitiv.com/elektron/elektron-sdk-java/docs?content=8736&type=documentation_item).\n",
@@ -2185,7 +2177,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.7.3"
+   "version": "3.7.4"
   }
  },
  "nbformat": 4,