summaryrefslogtreecommitdiff
path: root/docs/config_options.md
diff options
context:
space:
mode:
authorLess/Rikki <86894501+lesshonor@users.noreply.github.com>2022-09-29 13:08:45 -0400
committerGitHub <noreply@github.com>2022-09-29 13:08:45 -0400
commit00dc764f7268bd2780645eb07ce59892faba0341 (patch)
tree4a07236a3e2a905905f68e06e5a7e6d1e65a73ba /docs/config_options.md
parentbfcbcfe3c7efad948a026ad8c365007bb82d9b6a (diff)
[docs] Improve documentation regarding info.json (#18508)
* docs: raise info.json awareness * docs: note that DD migration is WIP
Diffstat (limited to 'docs/config_options.md')
-rw-r--r--docs/config_options.md12
1 files changed, 11 insertions, 1 deletions
diff --git a/docs/config_options.md b/docs/config_options.md
index 3e011a5cc9..02cfe83c69 100644
--- a/docs/config_options.md
+++ b/docs/config_options.md
@@ -2,7 +2,17 @@
QMK is nearly infinitely configurable. Wherever possible we err on the side of allowing users to customize their keyboard, even at the expense of code size. That level of flexibility makes for a daunting configuration experience, however.
-There are two main types of configuration files in QMK- `config.h` and `rules.mk`. These files exist at various levels in QMK and all files of the same type are combined to build the final configuration. The levels, from lowest priority to highest priority, are:
+There are three main types of configuration files in QMK:
+
+* `config.h`, which contains various preprocessor directives (`#define`, `#ifdef`)
+* `rules.mk`, which contains additional variables
+* `info.json`, which is utilized for [data-driven configuration](https://docs.qmk.fm/#/data_driven_config)
+
+This page will only discuss the first two types, `config.h` and `rules.mk`.
+
+?> While not all settings have data-driven equivalents yet, keyboard makers are encouraged to utilize the `info.json` file to set the metadata for their boards when possible. See the [`info.json` Format](https://docs.qmk.fm/#/reference_info_json) page for more details.
+
+These files exist at various levels in QMK and all files of the same type are combined to build the final configuration. The levels, from lowest priority to highest priority, are:
* QMK Default
* Keyboard