docs: enhance faq (#387)

* docs: fix grammatical error in faq

* docs: add tip for arm architecture with emulation in faq

* Update docs/getting-started/faq.md

Co-authored-by: Aevarkan <141498060+Aevarkan@users.noreply.github.com>

* docs: enhance Docker installation instructions for emulation on ARM architecture

* docs: update anchor link for Docker emulation

Co-authored-by: Aevarkan <141498060+Aevarkan@users.noreply.github.com>

* docs: move docker run instructions for emulation into start your server

* docs: fix x86-64 naming and macOS naming

Co-authored-by: Aevarkan <141498060+Aevarkan@users.noreply.github.com>

* docs: fix naming in start-your-server.md

Co-authored-by: Aevarkan <141498060+Aevarkan@users.noreply.github.com>

* docs: fix naming in a tab within start-your-server.md

Co-authored-by: Aevarkan <141498060+Aevarkan@users.noreply.github.com>

* docs: fix naming in installation.md

Co-authored-by: Aevarkan <141498060+Aevarkan@users.noreply.github.com>

* Update docs/getting-started/faq.md

Co-authored-by: Aevarkan <141498060+Aevarkan@users.noreply.github.com>

---------

Co-authored-by: Aevarkan <141498060+Aevarkan@users.noreply.github.com>
Co-authored-by: Vincent <magicdroidx@gmail.com>

Author: 3 people

docs/getting-started/faq.md

@@ -8,6 +8,10 @@ comments: true
 
     Endstone is built around the official [Bedrock Dedicated Server (BDS)](https://www.minecraft.net/download/server/bedrock), which supports Windows and Ubuntu Linux.
 
-    Accordingly, Endstone only supports Windows and Ubuntu Linux. Other platforms may or may function.
+    Accordingly, Endstone only supports Windows and Ubuntu Linux. Other platforms may or may not function.
 
-    BDS only supports the `x86-64` CPU architecture. Systems with `arm` CPU architectures are not supported.
+    BDS natively supports the `x86-64` CPU architecture. Systems with `arm` CPU architectures are not officially supported.[^1]
+
+[^1]: While BDS is natively built for `x86-64`, it can also run well on `arm` systems via [Docker emulation]. Using emulation can also allow Endstone to run on macOS.
+
+[Docker emulation]: installation.md/#with-docker-latest-arm-with-emulation

docs/getting-started/installation.md

@@ -67,16 +67,28 @@ from the last step. Open up a terminal and install Endstone with:
 ### with docker
 
 The official [Docker image] is a great way to get the Endstone server up and running in a few
-minutes. Open up a terminal and pull the image with:
+minutes, and enables you to run Endstone on ARM through emulation. Open up a terminal and pull the image with:
 
 === "Latest"
 
-    ```
+    ```shell
     docker pull endstone/endstone
     ```
 
+=== "Latest / :fontawesome-brands-apple: macOS / :fontawesome-solid-microchip: with emulation"
+
+    ```shell
+    docker pull --platform linux/amd64 endstone/endstone
+    ```
+
+    Note that if you are on an `x86-64` machine and you are not on macOS or Windows, emulation will not apply.
+
+If you're new to Docker, check out the [Docker beginner's guide].
+
 [Python package]: https://pypi.org/project/endstone/
 
 [virtual environment]: https://realpython.com/what-is-pip/#using-pip-in-a-python-virtual-environment
 
-[Docker image]: https://hub.docker.com/r/endstone/endstone/
+[Docker image]: https://hub.docker.com/r/endstone/endstone/
+
+[Docker beginner's guide]: https://docs.docker.com/get-started/

docs/getting-started/start-your-server.md

@@ -25,6 +25,20 @@ Alternatively, if you're running Endstone from within Docker, use:
     docker run --rm -it -v "%cd%":/home/endstone -p 19132:19132/udp endstone/endstone
     ```
 
+=== ":fontawesome-brands-linux: Linux / :fontawesome-brands-apple: macOS / :fontawesome-solid-microchip: with emulation"
+
+    ```
+    docker run \
+    --platform linux/amd64 \
+    -p 19132:19132 \
+    -it \
+    -v ${PWD}:/home/endstone \
+    --name endstone-server \
+    endstone/endstone
+    ```
+
+    Note that if you are on an `x86-64` machine and you are not on macOS or Windows, emulation will not apply.
+
 You should see this in your console:
 
 ![Start your server](start-your-server.png)