summaryrefslogtreecommitdiff
path: root/QUICK_START.md
diff options
context:
space:
mode:
authordragon788 <dragon788@users.noreply.github.com>2016-01-16 20:43:43 -0600
committerdragon788 <dragon788@users.noreply.github.com>2016-01-16 20:43:43 -0600
commit6c22bd66652eaf5a2e0c12d5517c9b8bc807318b (patch)
treef3ddd54be148fbb52ff779d16198e059ac3e127c /QUICK_START.md
parente04464c7ab455dcbee35be9f16c4e5a33a7261e7 (diff)
Create QUICK_START.md describing Vagrantfile usage
Provides links to software required to use the Vagrantfile.
Diffstat (limited to 'QUICK_START.md')
-rw-r--r--QUICK_START.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/QUICK_START.md b/QUICK_START.md
new file mode 100644
index 0000000000..f0165bc8ca
--- /dev/null
+++ b/QUICK_START.md
@@ -0,0 +1,21 @@
+# Quick Start Directions
+
+This project includes a Vagrantfile that will allow you to build a new firmware for your keyboard very easily without major changes to your primary operating system. This also ensures that when you clone the project and perform a build, you have the exact same environment as anyone else using the Vagrantfile to build. This makes it much easier for people to help you troubleshoot any issues you encounter.
+
+## Requirements
+
+Using the Vagrantfile in this repository requires you have [Vagrant](http://www.vagrantup.com/) as well as [VirtualBox](https://www.virtualbox.org/) (or [VMware Workstation](https://www.vmware.com/products/workstation) and [Vagrant VMware plugin](http://www.vagrantup.com/vmware) but the (paid) VMware plugin requires a licensed copy of VMware Workstation/Fusion).
+
+Other than having Vagrant and Virtualbox installed and possibly a restart of your computer afterwards, you can simple run a 'vagrant up' anywhere inside the folder where you checked out this project and it will start a Linux virtual machine that contains all the tools required to build this project. There is a post Vagrant startup hint that will get you off on the right foot, otherwise you can also reference the build documentation below.
+
+Build Firmware and Program Controller
+-------------------------------------
+See [doc/build.md](tmk_core/doc/build.md), or the README in the particular keyboard/* folder.
+
+Change your keymap
+------------------
+See [doc/keymap.md](tmk_core/doc/keymap.md).
+
+## Flashing the firmware
+
+The "easy" way to flash the firmware is using a tool from your host OS like the Teensy programming app. [ErgoDox EZ](keyboard/ergodox_ez/README.md) gives a great example.