ColemakMods / mod-dh

A Colemak mod for more comfortable typing.
Creative Commons Zero v1.0 Universal
685 stars 125 forks source link

Confusing documentation of changes from Colemak #92

Open almk-dev opened 1 month ago

almk-dev commented 1 month ago

Hello, I've been reading the documentation of changes between Colemak and Colemak-DH here, in deciding which to learn. I am specifically interested in the matrix/ortholinear layout.

The section mentions the following about the left-hand changes:

Three keys are relocated: D, G, B. This makes the D key much easier to type, using your index finger. The position of G is also improves, and reverts to its Qwerty placement. The B key moves from the hard-to-reach position at the bottom-middle to the new location on the top row.

However, as far as I can tell, a total of four (not three) keys are in different places. If we compare the standard Colemak and the Colemak-DH layouts, the letters D, G, B, and V are in different places.

Is this a mistake on the website or am I misunderstanding what is meant by relocated keys?

Standard

s319222127175862033_p64_i4_w1105

DH

colemak_dh_main_matrix

DreymaR commented 1 month ago

It's mostly a matter of perspective. On a row-stag using an Angle mod, the V key keeps its physical position with Cmk-DH. But logically, the V key is indeed moved which is clearly seen on the col-stagger images.

I usually say that four plus two keys are moved by the Curl-DH mod, fwiw.

stevep99 commented 1 month ago

The documentation was written at a time when most alternative layout folks were using traditional keyboards, and the explanation still reflects that. On a trad board, once the "angle mod" is applied to Z,X,C (i.e. moving location but keeping the standard finger assignment), only D, G, B change, since V stays on the same physical key.

almk-dev commented 1 month ago

Thanks for the explanations! I still think the site documentation could be more clear, either as a note for staggered/matrix layouts, or as an alternate diagram for both layouts with the correct changes listed.