diff --git a/build.md b/doc/build.md
similarity index 90%
rename from build.md
rename to doc/build.md
index 86ede59b..ea7c145d 100644
--- a/build.md
+++ b/doc/build.md
@@ -18,7 +18,7 @@ Then run one of the corresponding commands:
     make serve          # starts a server at http://localhost:7070
 
     # ... or build a docker image
-    docker build -t yarr .
+    docker build -t yarr -f etc/dockerfile .
 
 ## ARM compilation
 
@@ -26,7 +26,7 @@ The instructions below are to cross-compile *yarr* to `Linux/ARM*`.
 
 Build:
 
-    docker build -t yarr.arm -f dockerfile.arm .
+    docker build -t yarr.arm -f etc/dockerfile.arm .
 
 Test:
 
diff --git a/fever.md b/doc/fever.md
similarity index 100%
rename from fever.md
rename to doc/fever.md
diff --git a/dockerfile b/etc/dockerfile
similarity index 100%
rename from dockerfile
rename to etc/dockerfile
diff --git a/dockerfile.arm b/etc/dockerfile.arm
similarity index 100%
rename from dockerfile.arm
rename to etc/dockerfile.arm
diff --git a/readme.md b/readme.md
index 3d7b6875..8cda673e 100644
--- a/readme.md
+++ b/readme.md
@@ -28,9 +28,11 @@ Download `yarr-*-linux64.zip`, unzip it, place `yarr` in `$HOME/.local/bin`
 and run [the script](etc/install-linux.sh).
 
 For self-hosting, see `yarr -h` for auth, tls & server configuration flags.
-For building from source code, see [build.md](build.md)
 
-For Fever API support, see [fever.md](fever.md).
+See more:
+
+* [Building from source code](doc/build.md)
+* [Fever API support](doc/fever.md)
 
 ## credits