Revert to /docker, fix comments

.aspect/rules/external_repository_action_cache/npm_translate_lock_LTE4Nzc1MDcwNjU=

@@ -1,5 +1,7 @@
 # @generated
 # Input hashes for repository rule npm_translate_lock(name = "npm", pnpm_lock = "//:pnpm-lock.yaml").
 # This file should be checked into version control along with the pnpm-lock.yaml file.
-pnpm-lock.yaml=322447152
-package.json=1512585561
+.npmrc=-592547263
+pnpm-lock.yaml=104874376
+package-lock.json=-1109603374
+package.json=752745807

platform/linux/docker/README.md → docker/README.md

@@ -1,6 +1,9 @@
-# Linux
+# Building with Docker
 
-These steps will allow you to compile code as described [platform/linux/README.md](../README.md) using a Docker container. All the steps should be executed from the root of the repository.
+These steps will allow you to compile code as described [platform/linux/README.md](../platform/linux/README.md) using a Docker container. All the steps should be executed from the root of the repository.
+
+> [!IMPORTANT]  
+> Not all platform builds are currently supported. Docker builds are a work in progress.
 
 > [!IMPORTANT]  
 > You cannot build MapLibre native using both Docker and host methods at the same time. If you want to switch, you need to clean the repository first, e.g. by using this command:
@@ -21,20 +24,20 @@ docker build \
   -t maplibre-native-image \
   --build-arg USER_UID=$(id -u) \
   --build-arg USER_GID=$(id -g) \
-  -f platform/linux/docker/Dockerfile \
-  platform/linux/docker
+  -f docker/Dockerfile \
+  docker
 ```
 
 ## Run Docker Container
 
 ```bash
 # Run all build commands using the docker container.
 # You can also execute build commands from inside the docker container by starting it without the build command.
-docker run --rm -it -v "$PWD:/app/" -v "$PWD/platform/linux/docker/.cache:/home/user/.cache" maplibre-native-image
+docker run --rm -it -v "$PWD:/app/" -v "$PWD/docker/.cache:/home/user/.cache" maplibre-native-image
 ```
 
 You can also use the container to run just one specific commands, e.g. `cmake` or `bazel`. Any downloaded dependencies will be cached in the `docker/.cache` directory.
 
 ```bash
-docker run --rm -it -v "$PWD:/app/" -v "$PWD/platform/linux/docker/.cache:/home/user/.cache" maplibre-native-image cmake ...
+docker run --rm -it -v "$PWD:/app/" -v "$PWD/docker/.cache:/home/user/.cache" maplibre-native-image cmake ...
 ``` 

platform/linux/README.md

@@ -27,7 +27,7 @@ Optional: `libsqlite3-dev` (also available as vendored dependency).
 
 ### Building with Docker
 
-See instructions in [docker/README.md](docker/README.md) to build in a docker container.
+See instructions in [docker/README.md](../../docker/README.md) to build in a docker container.
 
 ## Build