dotnet / dotnet/dotnet-api-docs

AddLexicon Documentation contains sample code that does not work because of a reported BUG.

Open
#1,255 0 comments 0 reactions 0 assignees View on GitHub
area-System.Speech dotnet-api/prod Pri2
Dominant language
C#
Stars
949
Forks
1.7k
Avg merge
3d 27m
Merged PRs (30d)
49

Description

[Enter feedback here]
The information on this page, about adding a lexicon is of no use, because **adding a lexicon doesn't work**. Despite a bug apparently being filed on Microsoft Connect, **this bug still exists**.

If you try the sample code provided on this documentation page, **it doesn't work**. Either the bug needs fixing (which is unlikely) or this documentation needs removing from the internet and the function removing from the .Net framework.

Documenting features that do not work, is the biggest cause of wasted developer time, because we all assume that if anyone knows how things should work, it would be the developers of the product referred to in the documentation. Surely all sample code is **tested**, before submission to the actual documentation... isn't it?

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: 65c0de99-04af-423b-144a-21d0a9f7c5ac
* Version Independent ID: f1f39d11-446a-ba55-2809-536130eece21
* Content: [SpeechSynthesizer.AddLexicon(Uri, String) Method (System.Speech.Synthesis)](https://docs.microsoft.com/en-us/dotnet/api/system.speech.synthesis.speechsynthesizer.addlexicon?view=netframework-4.7.2)
* Content Source: [xml/System.Speech.Synthesis/SpeechSynthesizer.xml](https://github.com/dotnet/dotnet-api-docs/blob/master/xml/System.Speech.Synthesis/SpeechSynthesizer.xml)
* Product: **dotnet-api**
* GitHub Login: @dotnet-bot
* Microsoft Alias: **dotnetcontent**

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.