From b9234913f96e9917ba08a1a02eeebf88bf4ebda9 Mon Sep 17 00:00:00 2001
From: Jim O'Donnell <james.odonnell@dtc.ox.ac.uk>
Date: Mon, 18 Nov 2024 09:56:44 +0000
Subject: [PATCH 1/2] build: update Docker dev environment

- add some more local code directories to the docker dev build.
- update the docs.
---
 docker-compose.dev.yml     |  4 ++++
 docs/development/docker.md | 15 +++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml
index 84d0aab..d703b02 100644
--- a/docker-compose.dev.yml
+++ b/docker-compose.dev.yml
@@ -28,8 +28,12 @@ services:
         YAML_TEMPLATE: "config/oxford.yaml"
     command: "yarn dev"
     volumes:
+      - ./.material:/app/.material
+      - ./config:/app/config
       - ./components:/app/components
       - ./pages:/app/pages
+      - ./public:/app/public
+      - ./styles:/app/styles
     ports:
       - "3000:3000"
     links: 
diff --git a/docs/development/docker.md b/docs/development/docker.md
index 4a7d017..223985d 100644
--- a/docs/development/docker.md
+++ b/docs/development/docker.md
@@ -40,3 +40,18 @@ value (under `services.gutenberg.build.args`) to a different config yaml file or
 changing `MATERIAL_METHOD` to `"copy"` to copy a locally checked out folder into
 the container at build-time instead of pulling fresh - for more details on how
 to pull material to edit locally follow the below section.
+
+## Local development with Docker
+
+`docker-compose.dev.yaml` configures a local development environment in Docker,
+including Node and Yarn. It runs the app in development mode, so that you can make
+changes to the code and see them on http://localhost:3000.
+
+```sh
+# build the development image
+docker compose -f docker-compose.dev.yaml build
+# run the Next.js app on http://localhost:3000 in development mode
+docker compose -f docker-compose.dev.yaml up
+# shut down the app and database when you're finished
+docker compose -f docker-compose.dev.yaml down
+```

From 87ce564a2311ce2b551e78a25469ee41da4f7ec1 Mon Sep 17 00:00:00 2001
From: Jim O'Donnell <james.odonnell@dtc.ox.ac.uk>
Date: Mon, 18 Nov 2024 18:15:54 +0000
Subject: [PATCH 2/2] Add /lib to mounted volumes

---
 docker-compose.dev.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml
index d703b02..19b2bf4 100644
--- a/docker-compose.dev.yml
+++ b/docker-compose.dev.yml
@@ -31,6 +31,7 @@ services:
       - ./.material:/app/.material
       - ./config:/app/config
       - ./components:/app/components
+      - ./lib:/app/lib
       - ./pages:/app/pages
       - ./public:/app/public
       - ./styles:/app/styles