Add more info to the README

pull/389/head
Craig Disselkoen 7 years ago
parent 117f96cbdf
commit 69a69bae5e

@ -26,13 +26,35 @@ comes with important advantages:
unexpected will happen. Plover will not take over the keys. unexpected will happen. Plover will not take over the keys.
* The `GeminiPR` protocol supports language systems other than English. * The `GeminiPR` protocol supports language systems other than English.
All of this comes at a cost, however: the protocol is implemented over the Do note that the `GeminiPR` protocol is implemented over the virtual serial
virtual serial port, any plugin that wants to use that port too, will run into port, so any plugin that wants to use that port too, will run into
conflicts with the Steno plugin. In other words, don't use it together conflicts with the Steno plugin. In other words, don't use it together
with [Focus][k:focus]. with [Focus][k:focus].
[k:focus]: https://github.com/keyboardio/Kaleidoscope-Focus [k:focus]: https://github.com/keyboardio/Kaleidoscope-Focus
## What is Steno? Why should I use it? How do I learn?
As mentioned above, steno (short for "stenography") is a shorthand, chorded
input system that allows very fast input - licensed stenographers are required
to type **225 WPM at 95% accuracy** to get their license. Although reaching that
speed typically takes 2-6 years of practice and training, lower speeds
comparable to or exceeding that of touch typing can reportedly be reached in
only a few months.
[This talk][stenotalk] (YouTube link) gives a brief introduction to Steno, how
it works, and why it is cool.
[stenotalk]: https://youtu.be/Wpv-Qb-dB6g
One recommend way to get started with learning Steno is with [Plover][plover].
Plover is software for your computer that will interpret the steno input from
your Model 01 (or other NKRO QWERTY keyboard); it is available for Windows,
macOS, and Linux. Plover's [Beginner's Guide][ploverguide] is a great place to
get started with Steno in general and Plover in particular.
[ploverguide]: https://github.com/openstenoproject/plover/wiki/Beginner's-Guide:-Get-Started-with-Plover
## Using the plugin ## Using the plugin
To use the plugin, simply include the header in your Sketch, tell the firmware To use the plugin, simply include the header in your Sketch, tell the firmware
@ -64,6 +86,9 @@ The provided keys are: `FN`, `N1`, `N2`, `N3`, `N4`, `N5`, `N6`, `S1`, `S2`,
`ST3`, `ST4`, `E`, `U`, `FR`, `RR`, `PR`, `BR`, `LR`, `GR`, `TR`, `SR`, `DR`, `ST3`, `ST4`, `E`, `U`, `FR`, `RR`, `PR`, `BR`, `LR`, `GR`, `TR`, `SR`, `DR`,
`N7`, `N8`, `N9`, `NA`, `NB`, `NC`, `ZR`. `N7`, `N8`, `N9`, `NA`, `NB`, `NC`, `ZR`.
See the [example][plugin:example] for the default/suggested placements of each
of these keys.
## Plugin methods and properties ## Plugin methods and properties
The plugin provides a `GeminiPR` object, with no public methods or properties. The plugin provides a `GeminiPR` object, with no public methods or properties.

Loading…
Cancel
Save