Merge pull request #39482 from easyj2j/EmotionAPI

EmotionAPI-Update to MVC.

Author: v-shils

articles/cognitive-services/Emotion/Home.md

@@ -11,25 +11,23 @@ ms.date: 02/06/2017
 ms.author: anroth
 ---
 
-# Emotion API
+# What is Emotion API?
 
 > [!IMPORTANT]
-> Video API Preview will end on October 30th, 2017. Try the new [Video Indexer API Preview](https://azure.microsoft.com/services/cognitive-services/video-indexer/) to easily extract insights from 
-videos and to enhance content discovery experiences, such as search results, by detecting spoken words, faces, characters, and emotions. [Learn more](https://docs.microsoft.com/azure/cognitive-services/video-indexer/video-indexer-overview).
+> Emotion API was deprecated on October 30, 2017. The functionality is now part of [Face API](https://docs.microsoft.com/en-us/azure/cognitive-services/face/).
 
-Welcome to the Microsoft Emotion API, which allows you to build more personalized apps with Microsoft’s cutting edge cloud-based emotion recognition algorithm.
+Welcome to the Microsoft Emotion API, which allows you to build more personalized apps with Microsoft’s cloud-based emotion recognition algorithm.
 
 ### Emotion Recognition
 
-The Emotion API beta takes an image as an input, and returns the confidence across a set of emotions for each face in the image, as well as bounding box for the face, from the Face API. The emotions detected are happiness, sadness, surprise, anger, fear, contempt, disgust or neutral. These emotions are communicated cross-culturally and universally via the same basic facial expressions, where are identified by Emotion API. 
+The Emotion API beta takes an image as an input and returns the confidence across a set of emotions for each face in the image, as well as a bounding box for the face from the Face API. The emotions detected are happiness, sadness, surprise, anger, fear, contempt, disgust, or neutral. These emotions are communicated cross-culturally and universally via the same basic facial expressions, where are identified by Emotion API. 
 
 **Interpreting Results:** 
 
 In interpreting results from the Emotion API, the emotion detected should be interpreted as the emotion with the highest score, as scores are normalized to sum to one. Users may choose to set a higher confidence threshold within their application, depending on their needs. 
 
-For more details about emotion detection, please refer to the API Reference: 
+For more information about emotion detection, see the API Reference: 
   * Basic: If a user has already called the Face API, they can submit the face rectangle as an input and use the basic tier. [API Reference](https://westus.dev.cognitive.microsoft.com/docs/services/5639d931ca73072154c1ce89/operations/56f23eb019845524ec61c4d7)
   * Standard: If a user does not submit a face rectangle, they should use standard mode.  [API Reference](https://westus.dev.cognitive.microsoft.com/docs/services/5639d931ca73072154c1ce89/operations/563b31ea778daf121cc3a5fa)
 
-*Please note, Emotion API for Video was deprecated on October 30, 2017. For a sample on how to interpret streaming video with Emotion API, please see [How to Analyze Videos in Real Time](https://docs.microsoft.com/azure/cognitive-services/emotion/emotion-api-how-to-topics/howtoanalyzevideo_emotion).*
-
+For a sample on how to interpret streaming video with Emotion API, see [How to Analyze Videos in Real Time](https://docs.microsoft.com/azure/cognitive-services/emotion/emotion-api-how-to-topics/howtoanalyzevideo_emotion).

articles/cognitive-services/Emotion/toc.yml

@@ -1,36 +1,37 @@
 - name: Emotion API Documentation
 - name: Overview
-  href: Home.md
-- name: Quickstarts
-  expanded: true
   items:
-  - name: cURL
-    href: QuickStarts/curl.md
-  - name: C#
-    href: QuickStarts/CSharp.md
-  - name: Java
-    href: QuickStarts/Java.md
-  - name: JavaScript
-    href: QuickStarts/JavaScript.md
-  - name: PHP
-    href: QuickStarts/PHP.md
-  - name: Python
-    href: QuickStarts/Python.md
-  - name: Ruby
-    href: QuickStarts/Ruby.md
-- name: Tutorials
-  items:
-  - name: C#
-    href: Tutorials/CSharpTutorial.md
-  - name: Python
-    href: Tutorials/PythonTutorial.md
-- name: How to
+  - name: What is Emotion API
+    href: Home.md
+- name: How to guides
   items:
+  - name: Try Emotion API
+    items:
+    - name: C#
+      href: QuickStarts/CSharp.md
+    - name: cURL
+      href: QuickStarts/curl.md
+    - name: Java
+      href: QuickStarts/Java.md
+    - name: JavaScript
+      href: QuickStarts/JavaScript.md
+    - name: PHP
+      href: QuickStarts/PHP.md
+    - name: Python
+      href: QuickStarts/Python.md
+    - name: Ruby
+      href: QuickStarts/Ruby.md
+  - name: First Emotion API apps
+    items:
+    - name: C#
+      href: Tutorials/CSharpTutorial.md
+    - name: Python
+      href: Tutorials/PythonTutorial.md
   - name: Analyze videos in real time
     href: emotion-api-how-to-topics/HowtoAnalyzeVideo_Emotion.md
 - name: Reference
   items: 
-  - name: Emotion Reference
+  - name: Emotion API
     href: https://westus.dev.cognitive.microsoft.com/docs/services/5639d931ca73072154c1ce89
   - name: SDKs
     items:
@@ -40,10 +41,12 @@
       href: https://github.com/Microsoft/Cognitive-emotion-windows
 - name: Resources
   items: 
-  - name: Azure Roadmap
-    href: https://azure.microsoft.com/roadmap/
-  - name: Samples
-    href: https://azure.microsoft.com/resources/samples/?service=cognitive-services
   - name: FAQ
     href: FAQ.md
+  - name: UserVoice
+    href: https://cognitive.uservoice.com/forums/430312-emotion-api
+  - name: Stack Overflow
+    href: https://stackoverflow.com/questions/tagged/microsoft-cognitive
+  - name: Azure Roadmap
+    href: https://azure.microsoft.com/roadmap/?category=ai-machine-learning