Skip to content

Commit ab07b09

Browse files
author
mmccoyd
committed
Readme: Update QMK links. Put wiki link earlier
1 parent 1984b19 commit ab07b09

File tree

4 files changed

+14
-14
lines changed

4 files changed

+14
-14
lines changed

README.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -46,18 +46,10 @@ See the board readmes for details, rationales and default keymaps.
4646
*Keycaps*: Hillside boards are _only_ suitable for choc v1 switches and keycaps based on an 18 x 17mm switch spacing, such as the [MBK](https://mkultra.click/mbk-choc-keycaps), [Lowprokb LDSA](https://lowprokb.ca/products/ldsa-low-profile-blank-keycaps), [MoErgo MCC](https://mkultra.click/moergo-mcc-pom-1u-keycap/) or [Asymplex Choc](https://www.asymplex.xyz/category/choc). Not MX ones, nor 18 x 18mm ones such as Work Louder, nor Kailh Choc Transparent.
4747

4848
Hillside includes both
49-
[QMK firmware](https://github.com/qmk/qmk_firmware/tree/master/keyboards/handwired/hillside)
49+
[QMK firmware](https://github.com/qmk/qmk_firmware/tree/master/keyboards/hillside)
5050
and [ZMK Firmware](https://github.com/mmccoyd/zmk-config).
5151

5252

53-
## Key Use
54-
55-
I expect most people will primarily use either the tucked three thumbs or the extended three (not counting the upper thumb). They can choose where the thumb arc suits them best. I find the thumb finger is best for reaching the upper thumb key; clearing the lower thumb requires some care, but it is still very useful. The middle finger also handily reaches the most tucked thumb key, as the open space is a good reference. The keys outside of the primary three thumb keys are convenient for infrequent lock layers, escape, or for use when not actively typing for things such as mute.
56-
57-
## Why
58-
59-
Creating four boards is more than I intended. I wanted closer keys than MX boards, yet a few more keys than the Sweep (hence the 48). Yet I still missed the fuller bottom row of the Atreus for infrequent keys and felt people new to small boards would prefer a physical arrow cluster (hence the 56). But that put the extra keys too far for me, and I realized many 40% boards tuck the arrow cluster partly into the main rows. So I did that with some splay I wanted (hence the 52). But others like a more minimal board, and removing the partial bottom row was easy (hence the 46). So it was really three experiments for me, plus an easy variant.
60-
6153
## Hardware and Build Guide
6254

6355
See the [wiki](https://github.com/mmccoyd/hillside/wiki)
@@ -66,6 +58,14 @@ See the [wiki](https://github.com/mmccoyd/hillside/wiki)
6658
See [Forking and Modifying](https://github.com/mmccoyd/hillside/wiki/Forking%20and%20Modifying)
6759
on whether it would be difficult to modify these designs.
6860

61+
## Key Use
62+
63+
I expect most people will primarily use either the tucked three thumbs or the extended three (not counting the upper thumb). They can choose where the thumb arc suits them best. I find the thumb finger is best for reaching the upper thumb key; clearing the lower thumb requires some care, but it is still very useful. The middle finger also handily reaches the most tucked thumb key, as the open space is a good reference. The keys outside of the primary three thumb keys are convenient for infrequent lock layers, escape, or for use when not actively typing for things such as mute.
64+
65+
## Why
66+
67+
Creating four boards is more than I intended. I wanted closer keys than MX boards, yet a few more keys than the Sweep (hence the 48). Yet I still missed the fuller bottom row of the Atreus for infrequent keys and felt people new to small boards would prefer a physical arrow cluster (hence the 56). But that put the extra keys too far for me, and I realized many 40% boards tuck the arrow cluster partly into the main rows. So I did that with some splay I wanted (hence the 52). But others like a more minimal board, and removing the partial bottom row was easy (hence the 46). So it was really three experiments for me, plus an easy variant.
68+
6969
## Acknowledgments
7070

7171
The excellent Low Profile Keyboards and splitkb.com discord communities provided a fertile learning ground.

hillside46/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ It has the aggressive stagger of the Ferris plus
88
finger splay,
99
a longer thumb arc and break-off outer pinkie columns.
1010

11-
Splaying the columns lets our fingers more naturally follows our hand mechanics.
11+
Splaying the columns lets our fingers more naturally follow our hand mechanics.
1212
See the Hillside [family readme](../README.md) for features common to all hillside boards. Specific to the Hillside 46 are:
1313

1414
* Optional factory parts soldering except for the switches, MCU, TRRS, LEDs and battery switch.
@@ -20,7 +20,7 @@ See the Hillside [family readme](../README.md) for features common to all hillsi
2020

2121

2222
Hillside includes:
23-
[QMK firmware](https://github.com/qmk/qmk_firmware/tree/master/keyboards/handwired/hillside)
23+
[QMK firmware](https://github.com/qmk/qmk_firmware/tree/master/keyboards/hillside)
2424
with .json, .c,
2525
[via](https://github.com/mmccoyd/hillside/wiki/hill_46/via_config.json) and
2626
[vial](https://github.com/mmccoyd/vial-qmk/tree/hillside_46/keyboards/handwired/hillside/46/keymaps) keymaps,

hillside48/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,11 @@ See the Hillside [family readme](../README.md) for features common to all hillsi
1515
* Reversible 99 x 137mm PCB
1616

1717
Hillside includes both
18-
[QMK firmware](https://github.com/qmk/qmk_firmware/tree/master/keyboards/handwired/hillside)
18+
[QMK firmware](https://github.com/qmk/qmk_firmware/tree/master/keyboards/hillside)
1919
and [ZMK Firmware](https://github.com/mmccoyd/zmk-config).
2020

2121
## Keymap
22-
The default keymap has numbers and symbols along the top layer rows for familiarity, alternate hand modifiers for all keys and a navigation and editing layer. See the [keymap descrition](https://github.com/qmk/qmk_firmware/tree/master/keyboards/handwired/hillside/48/keymaps/default) for details.
22+
The default keymap has numbers and symbols along the top layer rows for familiarity, alternate hand modifiers for all keys and a navigation and editing layer. See the [keymap descrition](https://github.com/qmk/qmk_firmware/tree/master/keyboards/hillside/48/keymaps/default) for details.
2323

2424
```
2525
| ` | Q | W | E | R | T |-------------------| Y | U | I | O | P | BKSPC |

hillside52/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ See the Hillside [family readme](../README.md) for features common to all hillsi
1717
* Optional hotswap with Mill-Max switch sockets
1818

1919
Hillside includes:
20-
[QMK firmware](https://github.com/qmk/qmk_firmware/tree/master/keyboards/handwired/hillside)
20+
[QMK firmware](https://github.com/qmk/qmk_firmware/tree/master/keyboards/hillside)
2121
with .json, .c, [via](https://github.com/mmccoyd/hillside/wiki/hill_52/via_config.json) and [vial](https://github.com/mmccoyd/vial-qmk/tree/hillside_52/keyboards/handwired/hillside/52/keymaps) keymaps,
2222
[ZMK Firmware](https://github.com/mmccoyd/zmk-config),
2323
a [keyboard layout editor](http://www.keyboard-layout-editor.com/) loadable [diagram](https://github.com/mmccoyd/hillside/wiki/hill_52/keyboard-layout-editor.json)

0 commit comments

Comments
 (0)