summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorskullY <skullydazed@gmail.com>2020-02-20 11:57:43 -0800
committerskullydazed <skullydazed@users.noreply.github.com>2020-03-05 16:00:10 -0800
commit5b144560827d01b87e11be0e4539b35edca964ef (patch)
tree821081df80bd5bfc5ce215af144223a16e235f74 /docs
parentd1c18086d23c1f510ee434e1aa12b203f36e4794 (diff)
more wip
Diffstat (limited to 'docs')
-rw-r--r--docs/_summary.md220
-rw-r--r--docs/faq.md6
-rw-r--r--docs/newbs_getting_started.md4
3 files changed, 116 insertions, 114 deletions
diff --git a/docs/_summary.md b/docs/_summary.md
index 66465667ab..5edf61f6f1 100644
--- a/docs/_summary.md
+++ b/docs/_summary.md
@@ -1,125 +1,133 @@
-* [Complete Newbs Guide](newbs.md)
- * [Introduction](newbs_getting_started.md)
+* Complete Newbs Guide
+ * [Introduction](newbs.md)
+ * [Getting Started](newbs_getting_started.md)
* [Building Your First Firmware](newbs_building_firmware.md)
* [Flashing Firmware](newbs_flashing.md)
* [Testing and Debugging](newbs_testing_debugging.md)
* [Getting Help](getting_started_getting_help.md)
-* Guides
- * [ARM Debugging Guide](arm_debugging.md)
- * [Best Git Practices](newbs_git_best_practices.md)
- * [Contributing to QMK](contributing.md)
- * [Customizing Functionality](custom_quantum_functions.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)
- * [Vagrant Guide](getting_started_vagrant.md)
-
-* [Breaking Changes](breaking_changes.md)
+* Breaking Changes
+ * [Overview](breaking_changes.md)
* [My Pull Request Was Flagged](breaking_changes_instructions.md)
- * [2019 Aug 30](ChangeLog/20190830.md)
+ * History
+ * [2019 Aug 30](ChangeLog/20190830.md)
-* [FAQ](faq.md)
+* FAQs
* [General FAQ](faq_general.md)
* [Build/Compile QMK](faq_build.md)
* [Debugging/Troubleshooting QMK](faq_debug.md)
* [Keymap](faq_keymap.md)
* [Driver Installation with Zadig](driver_installation_zadig.md)
-* QMK Features
- * [Keycodes](keycodes.md)
- * [Basic Keycodes](keycodes_basic.md)
- * [US ANSI Shifted Keys](keycodes_us_ansi_shifted.md)
- * [Quantum Keycodes](quantum_keycodes.md)
- * [Advanced Keycodes](feature_advanced_keycodes.md)
- * [Auto Shift](feature_auto_shift.md)
- * Software Features
- * [Combos](feature_combo.md)
- * [Command](feature_command.md)
- * [Debounce API](feature_debounce_type.md)
- * [Dynamic Macros](feature_dynamic_macros.md)
- * [Grave Escape](feature_grave_esc.md)
- * [Key Lock](feature_key_lock.md)
- * [Leader Key](feature_leader_key.md)
- * [Macros](feature_macros.md)
- * [Mouse Keys](feature_mouse_keys.md)
- * [One Shot Keys](feature_advanced_keycodes.md#one-shot-keys)
- * [Pointing Device](feature_pointing_device.md)
- * [Space Cadet](feature_space_cadet.md)
- * [Swap Hands](feature_swap_hands.md)
- * [Tap Dance](feature_tap_dance.md)
- * [Terminal](feature_terminal.md)
- * [Unicode](feature_unicode.md)
- * [Userspace](feature_userspace.md)
- * Hardware Features
- * [Audio](feature_audio.md)
- * [Backlight](feature_backlight.md)
- * [Bluetooth](feature_bluetooth.md)
- * [Bootmagic](feature_bootmagic.md)
- * [Custom Matrix](custom_matrix.md)
- * [DIP Switch](feature_dip_switch.md)
- * [Encoders](feature_encoders.md)
- * [Haptic Feedback](feature_haptic_feedback.md)
- * [HD44780 LCD Controller](feature_hd44780.md)
- * [LED Matrix](feature_led_matrix.md)
- * [OLED Driver](feature_oled_driver.md)
- * [Proton C Conversion](proton_c_conversion.md)
- * [PS/2 Mouse](feature_ps2_mouse.md)
- * [RGB Lighting](feature_rgblight.md)
- * [RGB Matrix](feature_rgb_matrix.md)
- * [Split Keyboard](feature_split_keyboard.md)
- * [Stenography](feature_stenography.md)
- * [Thermal Printer](feature_thermal_printer.md)
- * [Velocikey](feature_velocikey.md)
+* Using QMK
+ * [Support](support.md)
+ * Guides
+ * [ARM Debugging Guide](arm_debugging.md)
+ * [Best Git Practices](newbs_git_best_practices.md)
+ * [Contributing to QMK](contributing.md)
+ * [Customizing Functionality](custom_quantum_functions.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)
+ * [Vagrant Guide](getting_started_vagrant.md)
+
+ * QMK Features
+ * [Keycodes](keycodes.md)
+ * [Basic Keycodes](keycodes_basic.md)
+ * [US ANSI Shifted Keys](keycodes_us_ansi_shifted.md)
+ * [Quantum Keycodes](quantum_keycodes.md)
+ * [Advanced Keycodes](feature_advanced_keycodes.md)
+ * [Auto Shift](feature_auto_shift.md)
-* QMK Reference
- * [Config Options](config_options.md)
- * [Make Documentation](getting_started_make_guide.md)
- * [Documentation Best Practices](documentation_best_practices.md)
- * [Documentation Templates](documentation_templates.md)
- * [Glossary](reference_glossary.md)
- * [Community Layouts](feature_layouts.md)
- * [Unit Testing](unit_testing.md)
- * [Useful Functions](ref_functions.md)
- * [Configurator Support](reference_configurator_support.md)
- * [info.json Format](reference_info_json.md)
+ * Software Features
+ * [Combos](feature_combo.md)
+ * [Command](feature_command.md)
+ * [Debounce API](feature_debounce_type.md)
+ * [Dynamic Macros](feature_dynamic_macros.md)
+ * [Grave Escape](feature_grave_esc.md)
+ * [Key Lock](feature_key_lock.md)
+ * [Leader Key](feature_leader_key.md)
+ * [Macros](feature_macros.md)
+ * [Mouse Keys](feature_mouse_keys.md)
+ * [One Shot Keys](feature_advanced_keycodes.md#one-shot-keys)
+ * [Pointing Device](feature_pointing_device.md)
+ * [Space Cadet](feature_space_cadet.md)
+ * [Swap Hands](feature_swap_hands.md)
+ * [Tap Dance](feature_tap_dance.md)
+ * [Terminal](feature_terminal.md)
+ * [Unicode](feature_unicode.md)
+ * [Userspace](feature_userspace.md)
-* C Development
- * [AVR Processors](hardware_avr.md)
- * [Coding Conventions](coding_conventions_c.md)
- * [Compatible Microcontrollers](compatible_microcontrollers.md)
- * [Drivers](hardware_drivers.md)
- * [ADC Driver](adc_driver.md)
- * [I2C Driver](i2c_driver.md)
- * [WS2812 Driver](ws2812_driver.md)
- * [EEPROM Driver](eeprom_driver.md)
- * [GPIO Controls](internals_gpio_control.md)
- * [Keyboard Guidelines](hardware_keyboard_guidelines.md)
+ * Hardware Features
+ * [Audio](feature_audio.md)
+ * [Backlight](feature_backlight.md)
+ * [Bluetooth](feature_bluetooth.md)
+ * [Bootmagic](feature_bootmagic.md)
+ * [Custom Matrix](custom_matrix.md)
+ * [DIP Switch](feature_dip_switch.md)
+ * [Encoders](feature_encoders.md)
+ * [Haptic Feedback](feature_haptic_feedback.md)
+ * [HD44780 LCD Controller](feature_hd44780.md)
+ * [LED Matrix](feature_led_matrix.md)
+ * [OLED Driver](feature_oled_driver.md)
+ * [Proton C Conversion](proton_c_conversion.md)
+ * [PS/2 Mouse](feature_ps2_mouse.md)
+ * [RGB Lighting](feature_rgblight.md)
+ * [RGB Matrix](feature_rgb_matrix.md)
+ * [Split Keyboard](feature_split_keyboard.md)
+ * [Stenography](feature_stenography.md)
+ * [Thermal Printer](feature_thermal_printer.md)
+ * [Velocikey](feature_velocikey.md)
-* Python Development
- * [Coding Conventions](coding_conventions_python.md)
- * [QMK CLI Config](cli_configuration.md)
- * [Python CLI Development](cli_development.md)
+ * Other Topics
+ * [Using Eclipse with QMK](other_eclipse.md)
+ * [Using VSCode with QMK](other_vscode.md)
-* For a Deeper Understanding
- * [How Keyboards Work](how_keyboards_work.md)
- * [Understanding QMK](understanding_qmk.md)
-* Other Topics
- * [Using Eclipse with QMK](other_eclipse.md)
- * [Using VSCode with QMK](other_vscode.md)
- * [Support](support.md)
- * [Translating the QMK Docs](translating.md)
+* Developing QMK
+ * QMK Reference
+ * [Translating the QMK Docs](translating.md)
+ * [Config Options](config_options.md)
+ * [Make Documentation](getting_started_make_guide.md)
+ * [Documentation Best Practices](documentation_best_practices.md)
+ * [Documentation Templates](documentation_templates.md)
+ * [Glossary](reference_glossary.md)
+ * [Community Layouts](feature_layouts.md)
+ * [Unit Testing](unit_testing.md)
+ * [Useful Functions](ref_functions.md)
+ * [Configurator Support](reference_configurator_support.md)
+ * [info.json Format](reference_info_json.md)
+
+ * C Development
+ * [AVR Processors](hardware_avr.md)
+ * [Coding Conventions](coding_conventions_c.md)
+ * [Compatible Microcontrollers](compatible_microcontrollers.md)
+ * [Drivers](hardware_drivers.md)
+ * [ADC Driver](adc_driver.md)
+ * [I2C Driver](i2c_driver.md)
+ * [WS2812 Driver](ws2812_driver.md)
+ * [EEPROM Driver](eeprom_driver.md)
+ * [GPIO Controls](internals_gpio_control.md)
+ * [Keyboard Guidelines](hardware_keyboard_guidelines.md)
+
+ * Python Development
+ * [Coding Conventions](coding_conventions_python.md)
+ * [QMK CLI Config](cli_configuration.md)
+ * [Python CLI Development](cli_development.md)
+
+ * For a Deeper Understanding
+ * [How Keyboards Work](how_keyboards_work.md)
+ * [Understanding QMK](understanding_qmk.md)
-* QMK Internals (In Progress)
- * [Defines](internals_defines.md)
- * [Input Callback Reg](internals_input_callback_reg.md)
- * [Midi Device](internals_midi_device.md)
- * [Midi Device Setup Process](internals_midi_device_setup_process.md)
- * [Midi Util](internals_midi_util.md)
- * [Send Functions](internals_send_functions.md)
- * [Sysex Tools](internals_sysex_tools.md)
+ * QMK Internals (In Progress)
+ * [Defines](internals_defines.md)
+ * [Input Callback Reg](internals_input_callback_reg.md)
+ * [Midi Device](internals_midi_device.md)
+ * [Midi Device Setup Process](internals_midi_device_setup_process.md)
+ * [Midi Util](internals_midi_util.md)
+ * [Send Functions](internals_send_functions.md)
+ * [Sysex Tools](internals_sysex_tools.md)
diff --git a/docs/faq.md b/docs/faq.md
deleted file mode 100644
index 506f57a72b..0000000000
--- a/docs/faq.md
+++ /dev/null
@@ -1,6 +0,0 @@
-# Frequently Asked Questions
-
-* [General](faq_general.md)
-* [Building or Compiling QMK](faq_build.md)
-* [Debugging and Troubleshooting QMK](faq_debug.md)
-* [Keymap](faq_keymap.md)
diff --git a/docs/newbs_getting_started.md b/docs/newbs_getting_started.md
index ae4b799a9c..1c7206cf51 100644
--- a/docs/newbs_getting_started.md
+++ b/docs/newbs_getting_started.md
@@ -1,10 +1,10 @@
-# Introduction
+# Getting Started
Your computer keyboard has a processor inside of it, not unlike the one inside your computer. This processor runs software that is responsible for detecting button presses and sending reports about the state of the keyboard when buttons are pressed or released. QMK fills the role of that software, detecting button presses and passing that information on to the host computer. When you build your custom keymap, you are creating the equivalent of an executable program for your keyboard.
QMK tries to put a lot of power into your hands by making easy things easy, and hard things possible. You don't have to know how to program to create powerful keymaps — you only have to follow a few simple syntax rules.
-# Getting Started
+# Prerequisites
Before you can build keymaps, you need to install some software and set up your build environment. This only has to be done once no matter how many keyboards you plan to compile firmware for.