~ruther/qmk_firmware

ref: 9b0887359bd6828a4071f7ce0dcd35eb0c8f98a1 qmk_firmware/docs/syllabus.md -rw-r--r-- 3.2 KiB
9b088735 — Pablo Martínez [Feature] Compilation warning if both `keymap.json` and `keymap.c` exist (#19939) 2 years ago

#QMK Syllabus

This page helps you build up your QMK knowledge by introducing the basics first and guiding you to understanding all the concepts you need to know to be proficient with QMK.

#Beginning Topics

If you read nothing else you should read the documents in this section. After reading the Tutorial you should be able to create a basic keymap, compile it, and flash it to your keyboard. The remaining documents will flesh out your knowledge of these basics.

  • Learn How To Use QMK Tools
  • Learn About Keymaps
    • Layers
    • Keycodes
      • The full list of keycodes you can use. Note that some may require knowledge found in the Intermediate or Advanced Topics.
  • Configuring IDEs - Optional

#Intermediate Topics

These topics start to dig into some of the features that QMK supports. You don't have to read all of these documents, but some of the documents in the Advanced Topics section won't make sense if you skip over some of these.

#Advanced Topics

Everything below here requires a lot of foundational knowledge. Besides being able to create keymaps using advanced features you should be familiar with using both config.h and rules.mk to configure options for your keyboard.