refactor: clean up repository layout

1 files changed, 9 insertions, 6 deletions

diff --git a/README.md b/README.md
index afa8008..5473379 100644
--- a/README.md
+++ b/README.md
@@ -6,31 +6,34 @@ I don't particularly care about the AoC leaderboard. December is usually a prett
 AoC gives each user their own puzzle input. I keep my inputs locally and do not commit them to this repository. If you're running these solutions yourself, you'll need to provide your own inputs in whatever format the corresponding solution expects.

 

 ## Docker

-The solutions are Linux x64 ELF binaries, so they don't run natively on macOS or Windows. The image bundles `nasm`, `ld`, and `make`. It's pinned to `linux/amd64`; on Apple Silicon it runs under emulation automatically (you'll see a harmless platform-mismatch warning).

+The solutions are Linux x64 ELF binaries, so they don't run natively on macOS or Windows. The image bundles `nasm`, `ld`, and `make`.

+

+Since the solutions target x86-64, the container should be run as `linux/amd64`. On Apple Silicon, Docker will run it under emulation.

 

 Build the image from the repository root:

 

 ```sh

-docker build -t aoc .

+docker build --platform=linux/amd64 -t aoc .

 ```

 

 List the available days:

 

 ```sh

-docker run --rm aoc list

+docker run --platform=linux/amd64 --rm aoc list

 ```

 

-### Inputs

 AoC inputs are per-user and are not committed to this repo. Put your input for a given day at `input/dayN.txt` in the repository root, then mount that directory when running so the solution can read it:

 

 ```sh

-docker run --rm -v "$PWD/input:/app/input" aoc day5

+docker run --platform=linux/amd64 --rm \

+    -v "$PWD/input:/app/input" \

+    aoc run DAY=5

 ```

 

 Assemble and link every day without running it — a quick build check that needs no input:

 

 ```sh

-docker run --rm aoc all

+docker run --platform=linux/amd64 --rm aoc all

 ```

 

 When you're done, remove the image with: