Updated FAQ (markdown)

[qmk_firmware.git] / FAQ.md

diff --git a/FAQ.md b/FAQ.md
index 631f98944af9b72c864127f16d1f8c20d4ff4bb2..4a89d6d50ab64a2f7122ab6589ef21bb4fa2edc3 100644 (file)
--- a/FAQ.md
+++ b/FAQ.md
@@ -1,14 +1,12 @@
-# Documents You Need To Read\r
-Read these yet?\r
- \r
-1. First **README** under top directory : https://github.com/tmk/tmk_keyboard/blob/master/README.md\r
-2. For **Build**: https://github.com/tmk/tmk_keyboard/blob/master/doc/build.md\r
-3. And **README** under each project(keyboard/converter) directory. Note that you should read two **README**.\r
-4. And then, FAQ.\r
+## READ FIRST\r
+- **README** of top directory : https://github.com/tmk/tmk_keyboard/blob/master/README.md\r
+- **README** of target project(keyboard/converter) directory.\r
+\r
+Note that you'll need to read **both**.\r
 \r
 \r
 # Build\r
-- [[FAQ/Build]\r
+- [[FAQ/Build]]\r
 \r
 \r
 # Keymap\r
@@ -55,14 +53,13 @@ SUBSYSTEMS=="usb", ATTRS{idVendor}=="feed", MODE:="0666"
 \r
 # Miscellaneous\r
 ## NKRO Doesn't work\r
-1. Build with this option of Makefile\r
-\r
-    NKRO_ENABLE = yes\r
+First you have to compile frimware with this build option `NKRO_ENABLE` in `Makefile`.\r
 \r
-2. After boot keyboard may be in **boot mode**(6KRO), you will need to replug keyboard to enable NKRO.\r
+Try `Magic` **N** command(`LShift+RShift+N` by default) when **NKRO** still doesn't work. You can use this command to toggle between **NKRO** and **6KRO** mode temporarily. In some situations **NKRO** doesn't work you need to switch to **6KRO** mode, in particular when you are in BIOS.\r
 \r
-3. Or use `Magic` **N** command to toggle NKRO function.(`LShift+RShift+N` by default)\r
+If your firmeare built with `BOOTMAGIC_ENABLE` you need to turn its switch on by `BootMagic` **N** command(`Space+N` by default). This setting is stored in EEPROM and keeped over power cycles.\r
 \r
+https://github.com/tmk/tmk_keyboard#boot-magic-configuration---virtual-dip-switch\r
 \r
 \r
 ## TrackPoint needs reset circuit(PS/2 mouse support)\r
@@ -122,7 +119,9 @@ Properly configure boot section size in Makefile. With wrong section size bootlo
 #   USBaspLoader     2048\r
 OPT_DEFS += -DBOOTLOADER_SIZE=4096\r
 ```\r
-http://geekhack.org/index.php?topic=12047.msg1292018#msg1292018\r
+\r
+And see this discussion.\r
+https://github.com/tmk/tmk_keyboard/issues/179\r
 \r
 \r
 ## Special Extra key doesn't work(System, Audio control keys)\r