aboutsummaryrefslogtreecommitdiffstats
path: root/docs/newbs.md
diff options
context:
space:
mode:
authorskullY <skullydazed@gmail.com>2020-02-20 15:50:50 -0800
committerskullydazed <skullydazed@users.noreply.github.com>2020-03-05 16:00:10 -0800
commita701c15d872ad171592335e61e91d7234dbec54a (patch)
treeef06fabdf0c0cd5d7457b63c48264700ac7fc67c /docs/newbs.md
parent1b7fa46f8e0616450bed8bff71bc1cffbca2eac8 (diff)
downloadfirmware-a701c15d872ad171592335e61e91d7234dbec54a.tar.gz
firmware-a701c15d872ad171592335e61e91d7234dbec54a.tar.bz2
firmware-a701c15d872ad171592335e61e91d7234dbec54a.zip
Rework the newbs guide around the qmk cli
Diffstat (limited to 'docs/newbs.md')
-rw-r--r--docs/newbs.md21
1 files changed, 12 insertions, 9 deletions
diff --git a/docs/newbs.md b/docs/newbs.md
index 775bba2ca..3efae9992 100644
--- a/docs/newbs.md
+++ b/docs/newbs.md
@@ -2,19 +2,22 @@
QMK is a powerful Open Source firmware for your mechanical keyboard. You can use QMK to customize your keyboard in ways both simple and powerful. People of all skill levels, from complete newbie to master programmer, have successfully used QMK to customize their keyboard. This guide will help you do the same, no matter your skill level.
-Not sure if your keyboard can run QMK? If it's a mechanical keyboard you built yourself chances are good it can. We support a [large number of hobbyist boards](http://qmk.fm/keyboards/), so even if your current keyboard can't run QMK you shouldn't have trouble finding one to suit your needs.
+Not sure if your keyboard can run QMK? If it's a mechanical keyboard you built yourself chances are good it can. We support a [large number of hobbyist boards](http://qmk.fm/keyboards/). If your current keyboard can't run QMK there are a lot of choices out there for boards that do.
+
+## Is This Guide For Me?
+
+This guide is suitable for everyone who wants to build a keyboard firmware using the source code. If you are already a programmer you will find the process very familiar and easier to follow. If the thought of programming intimidates you please [take a look at our online GUI](newbs_building_firmware_configurator.md) instead.
## Overview
-There are 7 main sections to this guide:
+There are 6 main sections to this guide:
-* [Getting Started](newbs_getting_started.md)
-* [Building Your First Firmware using the command line](newbs_building_firmware.md)
-* [Building Your First Firmware using the online GUI](newbs_building_firmware_configurator.md)
-* [Flashing Firmware](newbs_flashing.md)
-* [Testing and Debugging](newbs_testing_debugging.md)
-* [Best Git Practices](newbs_git_best_practices.md)
-* [Learn More with these Resources](newbs_learn_more_resources.md)
+1. [Getting Started](newbs_getting_started.md)
+2. [Building Your First Firmware](newbs_building_firmware.md)
+3. [Flashing Firmware](newbs_flashing.md)
+4. [Testing and Debugging](newbs_testing_debugging.md)
+5. [Best Git Practices](newbs_git_best_practices.md)
+6. [Learn More with these Resources](newbs_learn_more_resources.md)
This guide is focused on helping someone who has never compiled software before. It makes choices and recommendations based on that viewpoint. There are alternative methods for many of these procedures, and we support most of those alternatives. If you have any doubt about how to accomplish a task you can [ask us for guidance](getting_started_getting_help.md).