include layer explanations

readme.md

@@ -1,8 +1,27 @@
 # Aurora Sofle v2's Default Keymap
-_This keymap is a copy of the [Sofle default keymap](https://github.com/qmk/qmk_firmware/tree/master/keyboards/sofle/keymaps/default), with some modifications._
+This keymap is an original spin on the Halmak layout for the slovak layout, with programming in neovim in mind.
 
-A simple default keymap for the Aurora Sofle v2
+Keymaps in general are quite personal, so many of these key combinations might not work for you, so feel free to modify and adjust :).
-===============================================
 
-Keymaps in general are quite personal, so it is difficult to come up with a default that will suit every user. We hope this keymap serves as a good starting point for your own - although it should be fairly usable out-of-the-box.
+# Layers:
+Base layer, where the halmak experience resides:
+
+![image](https://github.com/djkato/sofle_halmak_sk_keymap/assets/25299243/e5258b57-2c25-4407-9944-98dc5b8a2256)
+
+For all symbols and nvim navigation. layer1 key+any symbols you might need, they're structured and placed in such a way that you can roll a finger to get matching pairs of symbols, like `(){}[]<>^`. Left hand has access to arrow keys and Page/home keys for quick navigation in vim layout outside `hjkl` programs.
+
+![image](https://github.com/djkato/sofle_halmak_sk_keymap/assets/25299243/cc1ce201-e466-46ea-8c9a-b6aa11685057)
+
+This layer serves as the main slovak layer, where the diacritics of a letter match layer positions to the base layer. This means `a` and `ä` are under the same key with layer button. Special symbols take priority, hence `ä` is under `a`, cause `á` can be key comboed with `shift+´+a`.
+
+![image](https://github.com/djkato/sofle_halmak_sk_keymap/assets/25299243/85c3828f-563c-4000-96c3-73f996904040)
+
+This is a toggle layer for gaming, turning on a basic qwerty like layout so it's not necessary to rebind all games to special layouts. The order is tqwert, because on the sofle v2 the key layout makes the homerow different, having `w` key be in the highest point makes more sense to me than have it be slanted.
+
+![image](https://github.com/djkato/sofle_halmak_sk_keymap/assets/25299243/5ac20a1b-3b4e-401a-982f-90fbb377480a)
+
+Shifts, alts, escapes, capslock and escapes usually stay static across different layers with some ergonomic alterations per layer (like added right-alt for symbol layer). 
+
+
+If there's an empty key, it probably means I found nothing that would fit there yet.