From cd522c2452c664cef34e8162ae53989474c7571e Mon Sep 17 00:00:00 2001 From: Chance Smith Date: Mon, 19 Jan 2026 13:26:08 -0600 Subject: [PATCH] docs(learning-the-layout) moved the technical to the Layout --- docs/CharaChorder One.rst | 15 ++++----------- docs/CharaChorder Two.rst | 15 ++++----------- docs/Layout.rst | 14 ++++++++++++++ docs/Master Forge.rst | 15 ++++----------- 4 files changed, 26 insertions(+), 33 deletions(-) diff --git a/docs/CharaChorder One.rst b/docs/CharaChorder One.rst index 03fcb66..23da870 100644 --- a/docs/CharaChorder One.rst +++ b/docs/CharaChorder One.rst @@ -283,24 +283,17 @@ You can read an explanation on all of the settings on your CharaChorder device : Learning the Layout ------------------- -The default CharaChorder layout, which we will refer to as the CC English layout, has been designed to favor bigrams and trigrams commonly used in the English language while making the letters accessible for a logical choice of :doc:`lexical chords`. You can find the quick reference guide for the layout below, and :ref:`read about how the layout was designed, here `. - -.. note:: - General consensus amongst the community is that, while not perfect, - the letter arrangement of the default layout is good enough that further modifications would provide very little benefit - considering 500+ WPM have been reached in peak conditions. - - **Most commonly only special character and number placement is changed**, for example to benefit coding. - - Some exceptions include optimizing for VIM bindings, though people have successfully used the default layout for VIM as well - and benefits of such modifications are debatable. +On the default CC English layout, all 26 letters are accessible without moving your hands from the home position. +You can find the quick reference guide below, and :ref:`read about how the layout was designed, here `. .. _CCEnglish Layout: .. image:: /assets/images/CCEnglish.png :width: 1200 :alt: CC English Layout +Ready to start learning? Start your training on `DOT I/O `__! + Layers ~~~~~~ diff --git a/docs/CharaChorder Two.rst b/docs/CharaChorder Two.rst index f739407..b6ac3f6 100644 --- a/docs/CharaChorder Two.rst +++ b/docs/CharaChorder Two.rst @@ -256,24 +256,17 @@ You can read an explanation on all of the settings on your CharaChorder device : Learning the Layout ------------------- -The default CharaChorder layout, which we will refer to as the CC English layout, has been designed to favor bigrams and trigrams commonly used in the English language while making the letters accessible for a logical choice of :doc:`lexical chords`. You can find the quick reference guide for the layout below, and :ref:`read about how the layout was designed, here `. - -.. note:: - General consensus amongst the community is that, while not perfect, - the letter arrangement of the default layout is good enough that further modifications would provide very little benefit - considering 500+ WPM have been reached in peak conditions. - - **Most commonly only special character and number placement is changed**, for example to benefit coding. - - Some exceptions include optimizing for VIM bindings, though people have successfully used the default layout for VIM as well - and benefits of such modifications are debatable. +On the default CC English layout, all 26 letters are accessible without moving your hands from the home position. +You can find the quick reference guide below, and :ref:`read about how the layout was designed, here `. .. _CCEnglish Layout: .. image:: /assets/images/CCEnglish2.png :width: 1200 :alt: CC English Layout +Ready to start learning? Start your training on `DOT I/O `__! + Layers ~~~~~~ diff --git a/docs/Layout.rst b/docs/Layout.rst index aefe109..0c9d77c 100644 --- a/docs/Layout.rst +++ b/docs/Layout.rst @@ -3,6 +3,11 @@ Layout ====== +Layout Philosophy +----------------- + +The default CC English layout is optimized around common letter pairs and triplets in English (bigrams and trigrams: 'er', 'at', 'ing'), so frequent words feel effortless to type and supports logical :doc:`lexical chords`. + Design of the layout -------------------- @@ -32,6 +37,15 @@ In general the process that Riley used and recommends using if you would like to 8. Analyze the weaknesses and strengths of your layout, then create a hypothesis of what could be changed within your seed to improve the total rating of all your bigrams, trigrams, and chords. 9. Shuffle your seed based on your hypothesis and repeat steps 5-9 until you are no longer able to improve upon your score +Community Consensus +------------------- + +The consensus is the default letter arrangement is effective as-is, with 500+ WPM achieved. + +**Most commonly only special character and number placement is changed**, for example to benefit coding. + +VIM users occasionally customize bindings, but many use the default. + Layout quirks ------------- diff --git a/docs/Master Forge.rst b/docs/Master Forge.rst index 881cb18..aae41d3 100644 --- a/docs/Master Forge.rst +++ b/docs/Master Forge.rst @@ -452,24 +452,17 @@ You can read an explanation on all of the settings on your CharaChorder device : Learning the Layout ------------------- -The default Master Forge layout, which we will refer to as the M4 English layout, has been designed to favor bigrams and trigrams commonly used in the English language while making the letters accessible for a logical choice of :doc:`lexical chords`. You can find the quick reference guide for the layout below, and :ref:`read about how the layout was designed, here `. - -.. note:: - General consensus amongst the community is that, while not perfect, - the letter arrangement of the default layout is good enough that further modifications would provide very little benefit - considering 500+ WPM have been reached in peak conditions. - - **Most commonly only special character and number placement are changed**, for example to benefit coding. - - Some exceptions include optimizing for VIM bindings, though people have successfully used the default layout for VIM as well - and benefits of such modifications are debatable. +On the default CC English layout, all 26 letters are accessible without moving your hands from the home position. +You can find the quick reference guide below, and :ref:`read about how the layout was designed, here `. .. _M4English Layout: .. image:: /assets/images/M4-Layout.png :width: 1200 :alt: M4 English Layout +Ready to start learning? Start your training on `DOT I/O `__! + Layers ~~~~~~