Skip to content

Commit bb7b9cb

Browse files
authored
Merge pull request #109692 from ktoliver/public-51312
[PUBLIC_MOVE] commit from public PR 51312
2 parents f419e04 + c798e90 commit bb7b9cb

File tree

1 file changed

+86
-87
lines changed

1 file changed

+86
-87
lines changed

articles/cognitive-services/cognitive-services-support-options.md

Lines changed: 86 additions & 87 deletions
Original file line numberDiff line numberDiff line change
@@ -11,19 +11,13 @@ ms.date: 11/22/2019
1111
ms.author: dapine
1212
---
1313

14-
# Azure Cognitive Services support and help options
14+
# Azure Cognitive Services support and feedback options
1515

16-
Are you just starting to explore the functionality of Azure Cognitive Services? Are you implementing a new feature in your application? Here are suggestions for where you can get help as a developer.
16+
Are you just starting to explore the functionality of Azure Cognitive Services? Perhaps you are implementing a new feature in your application. Or after using the service, do you have suggestions on how to improve it? Here are options for where you can get support, stay up-to-date, and give feedback for Cognitive Services.
1717

18-
> [!div class="checklist"]
19-
> * Stay informed about new developments in *Azure Cognitive Services*.
20-
> * Release notes contain information for all releases.
21-
> * Search to see if your issue was discussed by the community, or if existing documentation already exists.
22-
> * If you can't find a satisfactory answer, ask a question on *Stack Overflow*.
23-
> * If you find an issue with one of the samples on GitHub, raise a *GitHub* issue.
24-
> * Search for a solution in the *UserVoice forum*.
18+
## Get support
2519

26-
## Create an Azure support request
20+
### Create an Azure support request
2721

2822
<div class='icon is-large'>
2923
<img alt='Azure support' src='https://docs.microsoft.com/media/logos/logo_azure.svg'>
@@ -34,15 +28,33 @@ Explore the range of [Azure support options and choose the plan](https://azure.m
3428
* [Azure portal](https://ms.portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview)
3529
* [Azure portal for the United States government](https://portal.azure.us)
3630

37-
## Post a question on Stack Overflow
31+
### Search
32+
33+
<div class='icon is-large'>
34+
<img alt='Search' src='https://docs.microsoft.com/media/common/i_search.svg'>
35+
</div>
36+
37+
For faster results, perform a search to relevant sites such as [Stack Overflow](https://stackoverflow.com/), [Microsoft docs](https://docs.microsoft.com/azure/cognitive-services/), or [GitHub code samples](https://github.com/azure-samples). Use the `site:` query notation in your [favorite search engine](https://bing.com), for example:
38+
39+
```
40+
{search keywords} site:stackoverflow.com
41+
```
42+
43+
Where `{search keywords}` is the context of your search. Consider using these scoped searches appropriately:
44+
45+
- Stack Overflow: `site:stackoverflow.com`
46+
- Microsoft Docs: `site:docs.microsoft.com`
47+
- GitHub Samples: `site:github.com/azure-samples`
48+
49+
### Post a question on Stack Overflow
3850

3951
<div class='icon is-large'>
4052
<img alt='Stack Overflow' src='https://docs.microsoft.com/media/logos/logo_stackoverflow.svg'>
4153
</div>
4254

43-
For immediate answers from the community, look to Stack Overflow. Stack Overflow is the preferred channel for development-related questions. It's where members of the community and Microsoft team members are directly involved in helping you solve your problems.
55+
If you can't find an answer to your problem with the search box on Stack Overflow, submit a new question. Stack Overflow is the preferred channel for development-related questions. It's where members of the Stack Overflow community and Microsoft team members are directly involved in helping you solve your problems.
4456

45-
If you can't find an answer to your problem via search, submit a new question to Stack Overflow. Use one of the following tags when you formulate the question:
57+
Use one of the following tags when you formulate the question:
4658

4759
- [Microsoft Cognitive](https://stackoverflow.com/questions/tagged/microsoft-cognitive)
4860
- [Azure Cognitive Services](https://stackoverflow.com/questions/tagged/azure-cognitive-services)
@@ -52,39 +64,17 @@ If you can't find an answer to your problem via search, submit a new question to
5264
> * [How do I ask a good question?](https://stackoverflow.com/help/how-to-ask)
5365
> * [How to create a minimal, reproducible example?](https://stackoverflow.com/help/minimal-reproducible-example)
5466
55-
## UserVoice forum
56-
57-
<div class='icon is-large'>
58-
<img alt='UserVoice' src='https://docs.microsoft.com/media/logos/logo-uservoice.svg'>
59-
</div>
60-
61-
To request new features, post them on UserVoice. Share your ideas for making Cognitive Services and the accompanying APIs work better for the applications you develop:
67+
## Stay informed
6268

63-
| Service | Cognitive Services UserVoice URL |
64-
|-------------------------------|---------------|
65-
| Anomaly Detector | https://cognitive.uservoice.com/forums/912196-anomaly-detector |
66-
| Bing services | https://cognitive.uservoice.com/forums/555907-bing-search |
67-
| Computer Vision | https://cognitive.uservoice.com/forums/430309-computer-vision |
68-
| Content Moderator | https://cognitive.uservoice.com/forums/559960-content-moderator |
69-
| Custom Vision | https://cognitive.uservoice.com/forums/598141-custom-vision-service |
70-
| Face | https://cognitive.uservoice.com/forums/430315-face |
71-
| Form | https://cognitive.uservoice.com/forums/921556-form-recognizer |
72-
| Immersive | https://feedback.azure.com/forums/34192--general-feedback |
73-
| Language Understanding (LUIS) | https://cognitive.uservoice.com/forums/551524-luis |
74-
| Personalizer | https://cognitive.uservoice.com/forums/921562-personalizer |
75-
| QnA Maker | https://cognitive.uservoice.com/forums/578689-qna-maker |
76-
| Speech Services | https://cognitive.uservoice.com/forums/912208-speech-service |
77-
| Text Analytics | https://cognitive.uservoice.com/forums/555922-text-analytics |
78-
| Translator Text | https://cognitive.uservoice.com/forums/558796-translator |
79-
| Video Indexer | https://cognitive.uservoice.com/forums/598144-video-indexer |
69+
Staying informed about features in a new release or news on the Azure blog can help you find the difference between a programming error, a service bug, or a feature not yet available in Cognitive Services.
8070

81-
## Release notes
71+
### Release notes
8272

8373
<div class='icon is-large'>
8474
<img alt='Release notes' src='https://docs.microsoft.com/media/common/i_learn-about.svg'>
8575
</div>
8676

87-
The release notes are updated as new releases are made available. The notes contain information about new features, improvements, and bug fixes.
77+
The Cognitive Services release notes are updated as new releases are made available. The notes contain information about new features, improvements, and bug fixes.
8878

8979
- [Custom Vision](custom-vision-service/release-notes.md)
9080
- [Face](face/releasenotes.md)
@@ -93,89 +83,98 @@ The release notes are updated as new releases are made available. The notes cont
9383
- [Speech Services SDK](speech-service/devices-sdk-release-notes.md)
9484
- [Text Analytics](text-analytics/whats-new.md)
9585

96-
## Stay informed
86+
### Azure blog
9787

9888
<div class='icon is-large'>
9989
<img alt='Stay informed' src='https://docs.microsoft.com/media/common/i_blog.svg'>
10090
</div>
10191

10292
News about Cognitive Services is shared in the [Azure blog](https://azure.microsoft.com/blog/topics/cognitive-services/).
10393

104-
## Search
94+
### Reddit
10595

10696
<div class='icon is-large'>
107-
<img alt='Search' src='https://docs.microsoft.com/media/common/i_search.svg'>
97+
<img alt='Reddit' src='https://docs.microsoft.com/media/logos/logo_reddit.svg'>
10898
</div>
10999

110-
You might find the answer you need in the documentation, the samples, or answers to [Stack Overflow](https://www.stackoverflow.com) questions or in the samples.
111-
112-
- https://stackoverflow.com/questions/tagged/azure-cognitive-services
113-
114-
### Scoped search
100+
Reddit is a community-driven discussion website, offering the latest conversations about [Azure Cognitive Services](https://www.reddit.com/r/AZURE/search/?q=Cognitive%20Services&restrict_sr=1) news, help, info, tips, and tricks. Registered members can submit content and others can vote on it, which organically elevates the most relevant content to the top of their feeds.
115101

116-
For faster results, scope your search to relevant sites such as Stack Overflow, Microsoft docs, or GitHub code samples. Use the `site:` query notation in your [favorite search engine](https://bing.com):
117-
118-
```
119-
{search keywords} site:stackoverflow.com
120-
```
102+
## Give feedback
121103

122-
Where `{search keywords}` is the context of your search. This search will scope the results to Stack Overflow. Consider using these scoped searches appropriately:
123-
124-
- Stack Overflow: `site:stackoverflow.com`
125-
- Microsoft Docs: `site:docs.microsoft.com`
126-
- GitHub Samples: `site:github.com/azure-samples`
127-
128-
## Create a GitHub issue
104+
### UserVoice forum
129105

130106
<div class='icon is-large'>
131-
<img alt='GitHub' src='https://docs.microsoft.com/media/logos/logo_octokitty.svg'>
107+
<img alt='UserVoice' src='https://docs.microsoft.com/media/logos/logo-uservoice.svg'>
132108
</div>
133109

134-
Samples are often posted as open source. For questions and issues, create an *issue* in the respective GitHub repository. You can submit a pull request too! Looking for **Azure Samples** source code, below is a listing of Cognitive Services sample source code:
110+
To request new features, post them on UserVoice. Share your ideas for making Cognitive Services and its APIs work better for the applications you develop.
135111

136-
* [Azure Samples - Cognitive Services](https://github.com/Azure-Samples?utf8=%E2%9C%93&q=cognitive&type=&language=)
112+
> [!NOTE]
113+
> Although this is a public forum, don't expect support from Microsoft here, but do enjoy discussing new features you'd like to see in upcoming Cognitive Services releases.
137114
138-
You can create a bug report, feature request, or ask a general question and share best practices. For bug reports, please follow the provided template:
139115

140-
**Describe the bug**
116+
| Service | Cognitive Services UserVoice URL |
117+
|-------------------------------|---------------|
118+
| Anomaly Detector | https://cognitive.uservoice.com/forums/912196-anomaly-detector |
119+
| Bing services | https://cognitive.uservoice.com/forums/555907-bing-search |
120+
| Computer Vision | https://cognitive.uservoice.com/forums/430309-computer-vision |
121+
| Content Moderator | https://cognitive.uservoice.com/forums/559960-content-moderator |
122+
| Custom Vision | https://cognitive.uservoice.com/forums/598141-custom-vision-service |
123+
| Face | https://cognitive.uservoice.com/forums/430315-face |
124+
| Form Recognizer | https://cognitive.uservoice.com/forums/921556-form-recognizer |
125+
| Ink Recognizer | https://cognitive.uservoice.com/forums/921559-ink-recognizer |
126+
| Language Understanding (LUIS) | https://cognitive.uservoice.com/forums/551524-luis |
127+
| Personalizer | https://cognitive.uservoice.com/forums/921562-personalizer |
128+
| QnA Maker | https://cognitive.uservoice.com/forums/578689-qna-maker |
129+
| Speech Services | https://cognitive.uservoice.com/forums/912208-speech-service |
130+
| Custom Speech | https://cognitive.uservoice.com/forums/555934-custom-speech-service |
131+
| Text Analytics | https://cognitive.uservoice.com/forums/555922-text-analytics |
132+
| Translator Text | https://cognitive.uservoice.com/forums/558796-translator |
133+
| Video Indexer | https://cognitive.uservoice.com/forums/598144-video-indexer |
134+
135+
## Report bugs
141136

142-
A clear and concise description of what the bug is.
137+
### Create a GitHub issue or pull request
143138

144-
**To reproduce**
139+
<div class='icon is-large'>
140+
<img alt='GitHub' src='https://docs.microsoft.com/media/logos/logo_octokitty.svg'>
141+
</div>
145142

146-
Steps to reproduce the behavior:
147-
1. ...
148-
2. ...
143+
Below are three types of repositories where a developer might post an issue or create a pull request. To create an issue use the *Issues* tab in the respective GitHub repository and select *New issue*. If you want to suggest a correction, submit a pull request by editing a file directly. The pull request will then sit under the *Pull requests* tab until the repository owners can look it over.
149144

150-
**Expected behavior**
145+
#### Cognitive Services Samples
151146

152-
A clear and concise description of what you expected to happen.
147+
Samples are often found in public repositories as open source. The quickstart samples have their own repository and are referenced in the Microsoft documentation. If you find errors in the code, create an issue or a pull request.
153148

154-
**Which Cognitive Services offerings are you using**
149+
Here is a list of the Cognitive Services quickstart and sample code:
155150

156-
Detail the Cognitive Services offering that you're attempting to use, and provide details as to what you're trying to achieve.
151+
* [Azure Samples - Cognitive Services](https://github.com/Azure-Samples?utf8=%E2%9C%93&q=cognitive&type=&language=)
152+
* [Cognitive Services Quickstarts](https://github.com/Azure-Samples/cognitive-services-quickstart-code)
153+
* [Cognitive Services: Dotnet](https://github.com/Azure-Samples/cognitive-services-dotnet-sdk-samples)
154+
* [Cognitive Services: Go](https://github.com/Azure-Samples/azure-sdk-for-go-samples)
155+
* [Cognitive Services: Java](https://github.com/Azure-Samples/cognitive-services-java-sdk-samples)
156+
* [Cognitive Services: Node.js](https://github.com/Azure-Samples/cognitive-services-node-sdk-samples)
157+
* [Cognitive Services: Python](https://github.com/Azure-Samples/cognitive-services-node-sdk-samples)
157158

158-
**Platform, Operating System, and Programming Language**
159+
#### Cognitive Services SDK source code
159160

160-
- OS: [e.g., Windows, Linux, Android, iOS, ...] - please be specific
161-
- Hardware - x64, x86, ARM, ...
162-
- Browser, e.g., Chrome, Safari] (if applicable)- please be specific
161+
The source code of the SDKs show some of the underpinnings of the SDK for each service. If you have found a bug or want to suggest a correction, file an issue or create a pull request.
163162

164-
**Context**
163+
Here is a list of the Cognitive Services SDK source code by language:
165164

166-
- Error messages, log information, stack trace, ...
167-
- If you report an error for a specific service interaction, report the SessionId and time (incl. timezone) of the reported incidents. The SessionId is reported in all call-backs/events you receive.
168-
- Any other additional information
165+
* [Azure SDK for Dotnet](https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/cognitiveservices)
166+
* [Azure SDK for Go](https://github.com/Azure/azure-sdk-for-go/tree/master/services/cognitiveservices)<br>
167+
* [Azure SDK for Java](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/cognitiveservices)
168+
* [Azure SDK for JavaScript](https://github.com/Azure/azure-sdk-for-js/tree/master/sdk/cognitiveservices)
169+
* [Azure SDK for Python](https://github.com/Azure/azure-sdk-for-python/tree/master/sdk/cognitiveservices)
169170

170-
## Reddit
171+
#### Azure Cognitive Services documentation
171172

172-
<div class='icon is-large'>
173-
<img alt='Reddit' src='https://docs.microsoft.com/media/logos/logo_reddit.svg'>
174-
</div>
173+
The documentation for Cognitive Services explains how to use the service and provides examples and resources for the developer. If you have found a bug or want to suggest a correction, file an issue or create a pull request.
175174

176-
Reddit is community driven web content rating and discussion website, offering the latest details of [Azure Cognitive Services](https://www.reddit.com/r/AZURE/search/?q=Cognitive%20Services&restrict_sr=1). Registered members can submit content and others can vote on it - organically enabling the most relevant content will rise to the top.
175+
[MicrosoftDocs](https://github.com/MicrosoftDocs/azure-docs/tree/master/articles/cognitive-services)
177176

178177
## Next steps
179178

180179
> [!div class="nextstepaction"]
181-
> [What are Azure Cognitive Services?](welcome.md)
180+
> [What are Azure Cognitive Services?](welcome.md)

0 commit comments

Comments
 (0)