Updated README

README.md

@@ -1,22 +1,18 @@
 # Betalupi QMK environment
 
-This repository contains everything required to build qmk firmware.
+This repository contains my keyboards' firmware and everything you need to build it. It includes a docker container for building QMK firmware, since QMK installation modifies my computer a bit more than I'd like.
 
+## Usage
 
-### TODO
+You do not need a local install of QMK to build this firmware.
- - **Core:**
+You'll need docker, but there's a good chance you have that installed anyway.
- - Better build/flash command
- - Warning when directory is moved
- - **Keyboard:**
- - Random FFT animation
- - Clear leds on sleep (fft anim)
 
--------------------------------------------------
+1. `cd` into [`./docker`](./docker) and build the container.
+2. `mkdir ./output`
+3. Run `./build.sh`.
+4. Upload the firmware in `./output` to your keyboard using the proper tool.
+   - `wally-cli` works pretty well for the `betalupi_ergodox`
 
-
+## Todo
-## Building
+ - FFT Animation: clear leds on sleep
-
-`mkdir ./output` manually.
-
-Run `./build.sh`. Uses docker, doesn't need a local install of qmk.
 

docker/README.md

@@ -20,5 +20,6 @@ docker run -it \
 ## Building
 
 1. Before building, run `git submodule update --init --recursive`.
-2. Checkout whatever version of `qmk_firmware` you need
+   - Note that the submodules in this repo are linked to my local mirrors for speed. You'll probably need to update `qmk_cli` and `qmk_firmware` with github links.
+2. Checkout whatever version of `qmk_firmware` you need (optional).
 3. Run `docker build . -t git.betalupi.com/mark/qmk`