Update why with clearer intro and dark mode images #15
Conversation
There was a problem hiding this comment.
@mmccoyd I'm curious what's the reason for splitting some sentences onto multiple lines in the .MD source? I'm assuming those line breaks are not intended to render in the output content. Is there a rule of thumb you used for where line-breaks should occur in mid-sentence? If so, maybe it would be worth adding some sort of style guide for contributors? It looks very poetic :)
Looks pretty good overall, I like how you tightened up a lot of the text. Especially on the pages like the "why" page, it makes sense to keep the points bite-sized wherever possible.
|
Thanks for the comments! I'll take another pass on the words and see about a better graphic tool. The line breaks are habit from writing things collaboratively (in Latex) within git repos where a diff on a 12 word line is more workable than a diff on a 200 word line... With the breaks falling on clause breaks within the sentences. I recently learned it is called semantic line breaks. (https://sembr.org/). I'd written the first version in a more normal paragraph wrapping editor, so it may be a bit inconsistent. |
Cool! I love that kind of convention, it looks very practical. Would definitely suggest adding a comment at least recommending e.g. sembr to the README or something like that, so people know where to go to read about it and can try using it if they feel comfortable. |
|
Updated the images to more muted colors but with good font to background color contrast, tweaked the verbiage a tiny bit and added an image_readme file. |
|
Really great fixes. The key map looks way better now. |
- Full size, Half require a move - Split layer access to para after layer diagram - Split sentence - Start 40 para with their result, reduced stretching - Some like small with cool keycaps, cases. Big is just bulky - Verbs instead of nouns - Just tablet, skip phone - "to be under"
- Tighten full-size use of shift layer for capitals example - Starter 12-13x4 gives letters and space/mods/layer keys with low movement and simple layering - Tighten num row is sometimes handy - Tighten beginner example layout - Tradeoffs list Images: - Dark mode - Capitals layer in mini keymap example - Sys, not mods, on most tucked thumb/middle column
- Esc to stronger finger - No mod duplication in center - List OSM on layered home-row mods - Show other keys on pressed thumb arc as inaccessible - Example layers: show two edit keys
- intro reasons of size, cool, layers - compare to laptop board, not fullsize - remove 'sometimes ignoring ergonomics' - cleanup board size and example sections
- Good layering moves keys closer
Split this into an intro of reasons of: size, cool and layers. After that comes why layers help. Plus much nicer dark mode images.