Merge branch 'master' of https://github.com/MicrosoftDocs/azure-docs-pr into metadata-4

Author: ecfan

articles/aks/virtual-kubelet.md

@@ -203,6 +203,9 @@ Use the [az aks remove-connector][aks-remove-connector] command to remove Virtua
 az aks remove-connector --resource-group myAKSCluster --name myAKSCluster --connector-name virtual-kubelet
 ```
 
+> [!NOTE]
+> If you encounter errors removing both OS connectors, or want to remove just the Windows or Linux OS connector, you can manually specify the OS type. Add the `--os-type` parameter to the previous `az aks remove-connector` command, and specify `Windows` or `Linux`.
+
 ## Next steps
 
 For possible issues with the Virtual Kubelet, see the [Known quirks and workarounds][vk-troubleshooting]. To report problems with the Virtual Kubelet, [open a GitHub issue][vk-issues].

articles/ansible/ansible-manage-azure-dynamic-inventories.md

@@ -4,7 +4,7 @@ description: Learn how to use Ansible to manage your Azure dynamic inventories
 ms.service: ansible
 keywords: ansible, azure, devops, bash, cloudshell, dynamic inventory
 author: tomarcher
-manager: routlaw
+manager: jeconnoc
 ms.author: tarcher
 ms.date: 08/09/2018
 ms.topic: article

articles/ansible/ansible-matrix.md

@@ -4,7 +4,7 @@ description: Ansible module and version matrix for Azure
 ms.service: ansible
 keywords: ansible, roles, matrix, version, azure, devops
 author: tomarcher
-manager: routlaw
+manager: jeconnoc
 ms.author: tarcher
 ms.date: 07/02/2018
 ms.topic: article

articles/ansible/ansible-overview.md

@@ -4,7 +4,7 @@ description: Introduction to using Ansible to automates cloud provisioning, conf
 ms.service: ansible
 keywords: ansible, azure, devops, overview, cloud provision, configuration management, application deployment, ansible modules, ansible playbooks
 author: tomarcher
-manager: routlaw
+manager: jeconnoc
 ms.author: tarcher
 ms.date: 01/19/2018
 ms.topic: article

articles/ansible/index.yml

@@ -3,16 +3,14 @@ documentType: LandingData
 title: Ansible in Azure Documentation
 metadata:
   title: Ansible in Azure Documentation - Tutorials, samples, reference, and resources
-  meta.description: Learn how to use Ansible to automate cloud provisioning, configuration management, and application deployments.
-  services: terraform
-  author: tomarcher
-  manager: routlaw
+  description: Learn how to use Ansible to automate cloud provisioning, configuration management, and application deployments.
   ms.service: ansible
-  ms.tgt_pltfrm: na
-  ms.devlang: devops
-  ms.topic: landing-page
-  ms.date: 08/15/2018
+  keywords: ansible, azure, devops, tutorials, samples, reference
+  author: tomarcher
+  manager: jeconnoc
   ms.author: tarcher
+  ms.topic: landing-page
+  ms.date: 08/27/2018
 abstract:
   description: Use <a href="http://www.ansible.com">Ansible</a> to automate cloud provisioning, configuration management, and application deployments.
 sections:

articles/batch-ai/quickstart-python.md

@@ -167,7 +167,7 @@ parameters = models.ClusterCreateParameters(
         ),
     ),
 )
-batchai_client.clusters.create(resource_group_name, cluster_name,
+batchai_client.clusters.create(resource_group_name, workspace_name, cluster_name,
                                parameters).result()
 ```
 

articles/cognitive-services/LUIS/luis-tutorial-pattern-roles.md

@@ -50,7 +50,7 @@ In this tutorial, the Human Resources app detects utterances about moving new em
 |[Hierarchical (no roles)](luis-quickstart-intent-and-hier-entity.md)|mv Jill Jones from **a-2349** to **b-1298**|a-2349, b-1298|
 |This tutorial (with roles)|Move Billy Patterson from **Yuma** to **Denver**.|Yuma, Denver|
 
-You can't use the hierarchical entity in the pattern because only hierarchical parents are used in parents. In order to return the named locations of origin and destination, you muse use a pattern.
+You can't use the hierarchical entity in the pattern because only hierarchical parents are used in patterns. In order to return the named locations of origin and destination, you muse use a pattern.
 
 ### Simple entity for new employee name
 The name of the new employee, Billy Patterson, is not part of the list entity **Employee** yet. The new employee name is extracted first, in order to send the name to an external system to create the company credentials. After the company credentials are created, the employee credentials are added to the list entity **Employee**.
@@ -385,4 +385,4 @@ The intent score is now much higher and the role names are part of the entity re
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Learn best practices for LUIS apps](luis-concept-best-practices.md)
+> [Learn best practices for LUIS apps](luis-concept-best-practices.md)

articles/cognitive-services/Speech-Service/overview.md

@@ -7,71 +7,100 @@ author: v-jerkin
 
 ms.service: cognitive-services
 ms.component: speech-service
-ms.topic: article
+ms.topic: overview
 ms.date: 05/07/2018
 ms.author: v-jerkin
 ---
-# What is the Speech service (preview)?
+# What is the Speech service?
 
-With one subscription, the Speech service gives developers an easy way to add powerful speech-enabled features to their applications. Your apps can now feature voice command, transcription, dictation, speech synthesis, and speech translation.
+The Speech service unites the Azure speech features previously available via the [Bing Speech API](https://docs.microsoft.com/azure/cognitive-services/speech/home), [Translator Speech](https://docs.microsoft.com/azure/cognitive-services/translator-speech/), [Custom Speech](https://docs.microsoft.com/azure/cognitive-services/custom-speech-service/cognitive-services-custom-speech-home), and [Custom Voice](http://customvoice.ai/) services. Now, one subscription provides access to all of these capabilities.
 
-The Speech service is powered by the technologies used in other Microsoft products, including Cortana and Microsoft Office.
+Like the other Azure speech services, the Speech service is powered by the proven speech technologies used in products like Cortana and Microsoft Office. You can count on the quality of the results and the reliability of the Azure cloud.
 
 > [!NOTE]
-> The Speech service is currently in public preview. Return here regularly for updates to documentation, additional code samples, and more.
+> The Speech service is currently in public preview. Return here regularly for documentation updates, new code samples, and more.
 
-## Speech service features
+## Main Speech service functions
 
-|Function|Description|
+The primary functions of the Speech service are Speech to Text (also called speech recognition or transcription), Text to Speech (speech synthesis), and Speech Translation.
+
+|Function|Features|
 |-|-|
-|[Speech-to-text](speech-to-text.md)| Transcribes audio streams into text that your application can accept as input. Also integrates with the [Language Understanding service](https://docs.microsoft.com/azure/cognitive-services/luis/) (LUIS) to derive user intent from utterances.|
-|[Text-to-speech](text-to-speech.md)| Converts plain text to natural-sounding speech, delivered to your application in an audio file. Multiple voices, varying in gender or accent, are available for many supported languages. |
-|[Speech-translation](speech-translation.md)| Can be used either to translate streaming audio in near-real-time or to process recorded speech. |
-|Custom speech-to-text|You can customize speech-to-text by creating your own [acoustic](how-to-customize-acoustic-models.md) and [language](how-to-customize-language-model.md) models and by specifying custom [pronunciation](how-to-customize-pronunciation.md) rules. |
-|[Custom text-to-speech](how-to-customize-voice-font.md)|You can create your own voices for text-to-speech.|
-|[Speech Devices SDK](speech-devices-sdk.md)| With the introduction of the unified Speech service, Microsoft and its partners offer an integrated hardware/software platform optimized for developing speech-enabled devices |
+|[Speech to Text](speech-to-text.md)| <ul><li>Transcribes continuous real-time speech into text.<li>Can batch-transcribe speech from audio recordings. <li>Offers recognition modes for interactive, conversation, and dictation use cases.<li>Supports intermediate results, end-of-speech detection, automatic text formatting, and profanity masking. <li>Can call on [Language Understanding](https://docs.microsoft.com/azure/cognitive-services/luis/) (LUIS) to derive user intent from transcribed speech.\*|
+|[Text to Speech](text-to-speech.md)| <ul><li>Converts text to natural-sounding speech. <li>Offers Multiple genders and/or dialects for many supported languages. <li>Supports plain text input or Speech Synthesis Markup Language (SSML). |
+|[Speech Translation](speech-translation.md)| <ul><li>Translates streaming audio in near-real-time<li> Can also process recorded speech<li>Provides results as text or synthesized speech. |
+
+\* *Intent recognition requires a LUIS subscription.*
+
+
+## Customizing speech features
+
+The Speech service lets you use your own data to train the models underlying the Speech service's Speech to Text and Text to Speech features. 
+
+|Feature|Model|Purpose|
+|-|-|-|
+|Speech to Text|[Acoustic model](how-to-customize-acoustic-models.md)|Helps transcribe particular speakers and environments, such as cars or factories|
+||[Language model](how-to-customize-language-model.md)|Helps transcribe field-specific vocabulary and grammar, such as medical or IT jargon|
+||[Pronunciation model](how-to-customize-pronunciation.md)|Helps transcribe abbreviations and acronyms, such as "IOU" for "i oh you" |
+|Text to Seech|[Voice font](how-to-customize-voice-font.md)|Gives your app a voice of its own by training the model on samples of human speech.|
+
+Once created, your custom models can be used anywhere you'd use the standard models in your app's Speech to Text or Text to Speech functionality.
+
 
-## Access to the Speech service
+## Using the Speech service
 
-The Speech service is made available in two ways. [The SDK](speech-sdk.md) abstracts away the details of the network protocols for easier development on supported platforms. The [REST API](rest-apis.md) works with any programming language, but does not offer all the functions offered by the SDK.
+To simplify the development of speech-enabled applications, Microsoft provides the [Speech SDK](speech-sdk.md) for use with the new Speech service. The Speech SDK provides consistent native Speech to Text and Speech Translation APIs for C#, C++, and Java. If you're developing with one of these languages, the Speech SDK makes development easier by handling the network details for you.
+
+The Speech service also has a [REST API](rest-apis.md) that works with any programming language that can make HTTP requests. The REST interface, however, does not offer the streaming, real-time functionality ofthe SDK.
 
 |<br>Method|Speech<br>to Text|Text to<br>Speech|Speech<br>Translation|<br>Description|
 |-|-|-|-|-|
-|[SDKs](speech-sdk.md)|Yes|No|Yes|Libraries for specific programming languages, utilize Websocket-based procotol that simplify development.|
-|[REST](rest-apis.md)|Yes|Yes|No|A simple HTTP-based API that makes it easy to add speech to your application.|
+|[Speech SDK](speech-sdk.md)|Yes|No|Yes|Native APIs for C#, C++, and Java to simplify development.|
+|[REST](rest-apis.md)|Yes|Yes|No|A simple HTTP-based API that makes it easy to add speech to your applications.|
+
+### WebSockets
+
+The Speech service also has WebSockets protocols for streaming Speech to Text and Speech Translation. The Speech SDKs use these protocols to communicate with the Speech service. You should use the Speech SDK rather than trying to implement your own WebSockets communication with the Speech service.
+
+If you already have code that uses Bing Speech or Translator Speech via WebSockets, though, it is straightforward to update it to use the Speech service. The WebSockets protocols are compatible; only the endpoints are different.
+
+### Speech Devices SDK
+
+The [Speech Devices SDK](speech-devices-sdk.md) is an integrated hardware and software platform for developers of speech-enabled devices. Our hardware partner provides reference designs and development units. Microsoft provides a device-optimized SDK that takes full advantage of the hardware's capabilities.
+
 
 ## Speech scenarios
 
-A few common uses of speech technology are discussed briefly below. The [Speech SDK](speech-sdk.md) is central to most of these scenarios.
+Use cases for the Speech service include:
 
 > [!div class="checklist"]
 > * Create voice-triggered apps
 > * Transcribe call center recordings
 > * Implement voice bots
 
-### Voice-triggered apps
+### Voice user interface
 
-Voice input is a great way to make your app flexible, hands-free, and quick to use. In a voice-enabled app, users can just ask for the information they want rather than needing to navigate to it by clicking or tapping.
+Voice input is a great way to make your app flexible, hands-free, and quick to use. In a voice-enabled app, users can just ask for the information they want rather than needing to navigate to it.
 
-If your app is intended for use by the general public, you can use the baseline speech recognition model provided by the Speech service. It does a good job of recognizing a wide variety of speakers in typical environments.
+If your app is intended for use by the general public, you can use the default speech recognition models. They do a good job of recognizing a wide variety of speakers in common environments.
 
 If your app will be used in a specific domain (for example, medicine or IT), you can create a [language model](how-to-customize-language-model.md) to teach the Speech service about the special terminology used by your app.
 
 If your app will be used in a noisy environment, such as a factory, you can create a custom  [acoustic model](how-to-customize-acoustic-models.md) to better allow the Speech service to distinguish speech from noise.
 
 Getting started is as easy as downloading the [Speech SDK](speech-sdk.md) and following a relevant [Quickstart](quickstart-csharp-dotnet-windows.md) article.
 
-### Transcribe call center recordings
+### Call center transcription
 
 Often, call center recordings are only consulted if an issue arises with a call. With the Speech service, it's easy to transcribe every recording to text. Once they're text, you can easily index them for [full-text search](https://docs.microsoft.com/azure/search/search-what-is-azure-search) or apply [Text Analytics](https://docs.microsoft.com/azure/cognitive-services/Text-Analytics/) to detect sentiment, language, and key phrases.
 
-If your call center recordings often contain specialized terminology (such as product names or IT jargon), you can create a [language model](how-to-customize-language-model.md) to teach the Speech service that vocabulary. A custom [acoustic model](how-to-customize-acoustic-models.md) can help the Speech service understand less-than-optimal phone connections.
+If your call center recordings revolve around specialized terminology (such as product names or IT jargon), you can create a [language model](how-to-customize-language-model.md) to teach the Speech service that vocabulary. A custom [acoustic model](how-to-customize-acoustic-models.md) can help the Speech service understand less-than-optimal phone connections.
 
 For more information about this scenario, read more about [batch transcription](batch-transcription.md) with the Speech service.
 
 ### Voice bots
 
-[Bots](https://dev.botframework.com/) are an increasingly popular way of connecting users with the information they want, and customers with the businesses they love. Adding a conversational user interface to your Web site or app makes its functionality easier to find and quicker to access. With the Speech service, this conversation takes on a new dimension of fluency by actually responding to spoken queries with synthesized speech.
+[Bots](https://dev.botframework.com/) are an increasingly popular way of connecting users with the information they want, and customers with the businesses they love. Adding a conversational user interface to your Web site or app makes its functionality easier to find and quicker to access. With the Speech service, this conversation takes on a new dimension of fluency by responding to spoken queries in kind.
 
 To add a unique personality to your voice-enabled bot (and strengthen your brand), you can give it a voice of its own. Creating a custom voice is a two-step process. First, you [make recordings](record-custom-voice-samples.md) of the voice you want to use. Then you [submit those recordings](how-to-customize-voice-font.md) (along with a text transcript) to the Speech service's [voice customization portal](https://cris.ai/Home/CustomVoice), which does the rest. Once you've created your custom voice, it's straightforward to use it in your app.