diff --git a/README.md b/README.md
index 3bc5dea5..07036b6e 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,6 @@
 # Kaleidoscope
 
+
 Flexible firmware for Arduino-powered keyboards.
 
 This package contains the "core" of Kaleidoscope and a number of [example firmware "Sketches"](https://github.com/keyboardio/Kaleidoscope/tree/master/examples).
@@ -8,65 +9,51 @@ If you're just getting started with the Keyboardio Model 01, the [introductory d
 
 # Getting Started
 
-## Setup the Arduino IDE
 
-Setup the Arduino IDE on your system. Make sure you install at least version 1.8.6, since older version may not support all required features.
+If you want to use Kaleidoscope to customize or compile a "sketch" to power a supported keyboard, the fastest way to get started is to use the Arduino IDE. You can find [setup instructions](https://kaleidoscope.readthedocs.io/en/latest/quick_start.html) on [kaleidoscope.readthedocs.io](https://kaleidoscope.readthedocs.io)
 
-* On Linux, follow the instructions [on the wiki](https://github.com/keyboardio/Kaleidoscope/wiki/Install-Arduino-support-on-Linux).
-* On macOS, install using [homebrew](http://brew.sh/) [cask](https://caskroom.github.io/) with `brew cask install arduino` or download the application from [the official website](https://www.arduino.cc/en/Main/Software) and move it to your `/Applications` folder.
+If you prefer to work from the command line or intend to work on Kaleidscope itself, please follow the instructions below
 
-## Get into the right directory
+# Use git to check out a copy of Kaleidoscope
 
-### macOS
-```sh
-mkdir -p $HOME/Documents/Arduino/hardware
-cd $HOME/Documents/Arduino/hardware
-```
+1. Open a commandline shell and navigate to where you want to check out Kaleidoscope.
 
-### Linux
+For the purposes of this tutorial, we'll assume your checkout is in a directory called `kaleidoscope` inside a directory called `git` in your home directory.
 
 ```sh
-mkdir -p $HOME/Arduino/hardware
-cd $HOME/Arduino/hardware
+$ mkdir ~/git
+$ cd ~/git
 ```
 
-### Windows (Assuming cmd)
+2. Use git to download the latest version of Kaleidoscope
 
 ```sh
-mkdir %userprofile%\Documents\Arduino\hardware
-cd %userprofile%\Documents\Arduino\hardware
+$ git clone https://github.com/keyboardio/Kaleidoscope
 ```
 
+3.  Ask Kaleidoscope to install the compiler toolchain, arduino-cli and platform support
 
-### Install the libraries and hardware definitions
+```sh
+$ cd Kaleidoscope
+$ make setup
+````
 
-## Clone the hardware definitions
+4.  Build the Kaleidoscope Firmware for your keyboard
 
-Because git for Windows doesn't always have symlink support enabled by default, you may need to enable it for Kaleidoscope. To do that, add '-c core.symlinks=true' to your commandline. On all other platforms, that option is safe, but not necessary, as symlinks should work by default.
+(This part assumes you're building firmware for the Keyboardio Atreus)
 
 ```sh
-git clone -c core.symlinks=true --recursive https://github.com/keyboardio/Kaleidoscope-Bundle-Keyboardio.git keyboardio
+$ cd examples/Devices/Keyboardio/Atreus
 
+$ make compile
 ```
 
-## Build the Kaleidoscope Firmware for your keyboard
-
-(This part assumes you're building firmware for the Keyboardio Model 01)
+5.  Install your firmware
 
 ```sh
-# Go to your device firmware directory
-cd keyboardio/avr/libraries/Model01-Firmware
-
-# Build your firmware!
-make
-
-
-# Install your firmware
-make flash
+$ make flash
 
 ```
 
 <3 jesse
 
-[![Build
-Status](https://travis-ci.org/keyboardio/Kaleidoscope.svg?branch=master)](https://travis-ci.org/keyboardio/Kaleidoscope)