Improved Getting Started page for non-programmers #307
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
for more information, see https://pre-commit.ci
❌ Deploy Preview for talon-wiki-refactor failed.
|
✅ Deploy Preview for talon-wiki-refactor ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
…e end of `directiveContainer`
…b.com/ronzulu/talon-community-wiki into issue-170-improve-for-non-programmers
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
I've recently started exploring Talon, and agree with @2shea that the circular reference between https://talonvoice.com/ and https://talon.wiki is confusing.
Getting Started page should be more accessible to folks with non-programming background #170
I understand why writers of this wiki wanted to refer back to the official site, but I think it just makes things more difficult for new users.
As it would seem that information on the official site is infrequently updated, I don't think there's much practical issue in incorporating the information there into this wiki.
Getting Started Page
Specifically, I have:
Removed "You can also install and run Talon by following the official installation instructions. This info supplements that page."
Added a first step of checking system requirements.
Added platform specific download links so that https://talonvoice.com does not need to be referenced.
Included a screenshot of selecting the
Conformer Drecognition engine.Created a new step "6: Next steps", and moved various points previously under "Test your Talon Setup" to here.
Hardware Page
Change title to "Hardware & OS"
Added a new section for "Operating System". This contains the relevant info from https://talonvoice.com. Again to avoid a circular reference between it and this wiki.