From 3f1e47dbcd2a03f791d968f13ded33fde597f1fb Mon Sep 17 00:00:00 2001 From: skullY Date: Thu, 20 Feb 2020 13:09:37 -0800 Subject: [PATCH] rework the index page --- docs/README.md | 26 ++++++++++---------------- docs/_summary.md | 3 ++- 2 files changed, 12 insertions(+), 17 deletions(-) diff --git a/docs/README.md b/docs/README.md index 9f9ca166bdf..5f1f2975493 100644 --- a/docs/README.md +++ b/docs/README.md @@ -9,24 +9,18 @@ ## What is QMK Firmware? -QMK (*Quantum Mechanical Keyboard*) is an open source community that maintains QMK Firmware, QMK Toolbox, 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. +QMK (*Quantum Mechanical Keyboard*) is an open source community centered around developing computer input devices. Early on the community was keyboard focused, but has now grown to include mice and MIDI devices as well. The community maintains [QMK Firmware](https://github.com/qmk/qmk_firmware), [QMK Configurator](https://config.qmk.fm), [QMK Toolbox](https://github.com/qmk/qmk_toolbox), [qmk.fm](https://qmk.fm), and this documentation. -## How to Get It +## Get Started -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. +Totally new to QMK? There are two ways to get started: -Otherwise, you can clone it directly with `git clone https://github.com/qmk/qmk_firmware`. Do not download the zip or tar files; a git repository is required to download the submodules in order to compile. +* Basic: [QMK Configurator](https://config.qmk.fm) + * Just select your keyboard from the dropdown and program your keyboard. + * We have an [introductory video](https://www.youtube.com/watch?v=-imgglzDMdY) you can watch. +* Advanced: [Use The Source](newbs.md) + * More powerful, but harder to use -## How to Compile +## Make It Yours -Before you are able to compile, you'll need to [install an environment](getting_started_build_tools.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 or folders), in which case, it can be omitted: - - make preonic:default - -## How to Customize - -QMK has lots of [features](features.md) to explore, and a good deal of [reference documentation](http://docs.qmk.fm) to dig through. Most features are taken advantage of by modifying your [keymap](keymap.md), and changing the [keycodes](keycodes.md). +QMK has lots of [features](features.md) to explore, and a good deal of reference documentation to dig through. Most features are taken advantage of by modifying your [keymap](keymap.md), and changing the [keycodes](keycodes.md). diff --git a/docs/_summary.md b/docs/_summary.md index 5edf61f6f15..5486a7e9e32 100644 --- a/docs/_summary.md +++ b/docs/_summary.md @@ -26,10 +26,11 @@ * [Best Git Practices](newbs_git_best_practices.md) * [Contributing to QMK](contributing.md) * [Customizing Functionality](custom_quantum_functions.md) + * [Flashing ATmega32A (ps2avrgb)](flashing_bootloadhid.md) + * [Flashing Firmware](flashing.md) * [Github Best Practices](getting_started_github.md) * [Hand Wiring Guide](hand_wire.md) * [ISP Flashing Guide](isp_flashing_guide.md) - * [Flashing Firmware](flashing.md) * [Keymap Overview](keymap.md) * [Learning Resources](newbs_learn_more_resources.md) * [QMK CLI](cli.md)