documentation
documentation copied to clipboard
Language support docs are not very good
the language support docs make a few wrong assumptions:
- wakeword must be in new language
- pocketsphinx models must be downloaded
- pocketsphinx offline STT prs must be merged
Wakeword:
-
wakeword supports a language parameter, so we can use english wake words
-
i actually recommend this because phonemes are different in other languages, so expect a bunch of questions why phonemes don't work
-
docs should say downloading pocketsphinx models is optional, and warn about different phonemes
Language:
this part is just wrong, in the sense that those are instructions for a unmerged PR, that is not related to this task at all, new STT != adding new language
As an alternative, you can use PocketSphinx, running on your local machine. To use PocketSphinx as your STT engine, add the following to your mycroft.conf file:
"listener": {
"producer": "pocketsphinx",
"grammar": "lm"
}
- it depends on 1 of 3 possible PRs for pocketsphinx, the oldest and closed one!
- Pocketsphinx accuracy is not good, users will not only be confused but also have bad performance if they somehow succeed
- it's unclear that the default stt (mycroft/google) supports most languages and is the most accurate one, mycroft supports most languages by default, why make it seem so arcane and difficult?
- "If the Speech to Text engine you are using already supports Spanish, you don't need to do anything." is super vague, why not have a list of supported languages instead?
- TTS support just recommends using espeak, i spent quite some time investigating available TTS and supported languages
There's lots of optional steps being given as mandatory, and some important things just missing, there is no mention of translating individual skills for example, and the remote config will likely cause trouble for those following the guide, i don't think you want to tell people to disable home.mycroft.ai for this purpose, so the guide should include pictures of using the home portal and not only the config :)
here is my guide for language support https://jarbasai.github.io//posts/2017/09/language/