]> git.donarmstrong.com Git - qmk_firmware.git/commitdiff
use default base names
authorJack Humbert <jack.humb@gmail.com>
Thu, 29 Jun 2017 16:25:29 +0000 (12:25 -0400)
committerJack Humbert <jack.humb@gmail.com>
Thu, 29 Jun 2017 16:25:29 +0000 (12:25 -0400)
book.json
docs/README.md [new file with mode: 0644]
docs/_summary.md
docs/home.md [deleted file]

index ff19e2974ade2791cdac982d698d6a197df6935c..3da42c4b1c447719b2abbd5b5a6c1996bd38f87f 100644 (file)
--- a/book.json
+++ b/book.json
@@ -1,6 +1,5 @@
 {
     "structure": {
-        "readme": "home.md",
         "summary": "_summary.md"
     },
     "plugins" : ["toolbar", "edit-link", "anchors"],
diff --git a/docs/README.md b/docs/README.md
new file mode 100644 (file)
index 0000000..3346df2
--- /dev/null
@@ -0,0 +1,32 @@
+# Quantum Mechanical Keyboard Firmware
+
+## Getting started
+
+* [What is QMK Firmware?](#what-is-qmk-firmware)
+* [How to get it](#how-to-get-it)
+* [How to compile](#how-to-compile)
+* [How to customize](#how-to-customize)
+
+### What is QMK Firmware? {#what-is-qmk-firmware}
+
+QMK (*Quantum Mechanical Keyboard*) is an open source community that maintains QMK Firmware, QMK Flasher, qmk.fm, and these docs. QMK Firmware is a keyboard firmware based on the [tmk\_keyboard](http://github.com/tmk/tmk_keyboard) with some useful features for Atmel AVR controllers, and more specifically, the [OLKB product line](http://olkb.com), the [ErgoDox EZ](http://www.ergodox-ez.com) keyboard, and the [Clueboard product line](http://clueboard.co/). It has also been ported to ARM chips using ChibiOS. You can use it to power your own hand-wired or custom keyboard PCB.
+
+### How to get it {#how-to-get-it}
+
+If you plan on contributing a keymap, keyboard, or features to QMK, the easiest thing to do is [fork the repo through Github](https://github.com/qmk/qmk_firmware#fork-destination-box), and clone your repo locally to make your changes, push them, then open a [Pull Request](https://github.com/qmk/qmk_firmware/pulls) from your fork.
+
+Otherwise, you can either download it directly ([zip](https://github.com/qmk/qmk_firmware/zipball/master), [tar](https://github.com/qmk/qmk_firmware/tarball/master)), or clone it via git (`git@github.com:qmk/qmk_firmware.git`), or https (`https://github.com/qmk/qmk_firmware.git`).
+
+### How to compile {#how-to-compile}
+
+Before you are able to compile, you'll need to [install an environment](build_environment_setup.md) for AVR or/and ARM development. Once that is complete, you'll use the `make` command to build a keyboard and keymap with the following notation:
+
+    make planck-rev4-default
+
+This would build the `rev4` revision of the `planck` with the `default` keymap. Not all keyboards have revisions (also called subprojects), in which case, it can be omitted:
+
+    make preonic-default
+
+### How to customize {#how-to-customize}
+
+QMK has lots of [features](features/README.md) to explore, and a good deal of [reference documentation](reference/README.md) to dig through. Most features are taken advantage of by modifying your [keymap](keymap.md), and changing the [keycodes](keycodes.md).
\ No newline at end of file
index f2229be694affa51f20e2b489e03c7dafe070d14..115132cd30fd0c148de7a80562df7ab9c10b8ff6 100644 (file)
@@ -1,5 +1,4 @@
-* Getting started 
-  * [Introduction](home.md)
+* [Getting started](README.md) 
   * [QMK Overview](qmk_overview.md)
   * [Build Environment Setup](build_environment_setup.md)
   * [Make instructions](make_instructions.md)
diff --git a/docs/home.md b/docs/home.md
deleted file mode 100644 (file)
index 3346df2..0000000
+++ /dev/null
@@ -1,32 +0,0 @@
-# Quantum Mechanical Keyboard Firmware
-
-## Getting started
-
-* [What is QMK Firmware?](#what-is-qmk-firmware)
-* [How to get it](#how-to-get-it)
-* [How to compile](#how-to-compile)
-* [How to customize](#how-to-customize)
-
-### What is QMK Firmware? {#what-is-qmk-firmware}
-
-QMK (*Quantum Mechanical Keyboard*) is an open source community that maintains QMK Firmware, QMK Flasher, qmk.fm, and these docs. QMK Firmware is a keyboard firmware based on the [tmk\_keyboard](http://github.com/tmk/tmk_keyboard) with some useful features for Atmel AVR controllers, and more specifically, the [OLKB product line](http://olkb.com), the [ErgoDox EZ](http://www.ergodox-ez.com) keyboard, and the [Clueboard product line](http://clueboard.co/). It has also been ported to ARM chips using ChibiOS. You can use it to power your own hand-wired or custom keyboard PCB.
-
-### How to get it {#how-to-get-it}
-
-If you plan on contributing a keymap, keyboard, or features to QMK, the easiest thing to do is [fork the repo through Github](https://github.com/qmk/qmk_firmware#fork-destination-box), and clone your repo locally to make your changes, push them, then open a [Pull Request](https://github.com/qmk/qmk_firmware/pulls) from your fork.
-
-Otherwise, you can either download it directly ([zip](https://github.com/qmk/qmk_firmware/zipball/master), [tar](https://github.com/qmk/qmk_firmware/tarball/master)), or clone it via git (`git@github.com:qmk/qmk_firmware.git`), or https (`https://github.com/qmk/qmk_firmware.git`).
-
-### How to compile {#how-to-compile}
-
-Before you are able to compile, you'll need to [install an environment](build_environment_setup.md) for AVR or/and ARM development. Once that is complete, you'll use the `make` command to build a keyboard and keymap with the following notation:
-
-    make planck-rev4-default
-
-This would build the `rev4` revision of the `planck` with the `default` keymap. Not all keyboards have revisions (also called subprojects), in which case, it can be omitted:
-
-    make preonic-default
-
-### How to customize {#how-to-customize}
-
-QMK has lots of [features](features/README.md) to explore, and a good deal of [reference documentation](reference/README.md) to dig through. Most features are taken advantage of by modifying your [keymap](keymap.md), and changing the [keycodes](keycodes.md).
\ No newline at end of file