Environment-and-Configuration.md

@@ -5,11 +5,13 @@ A lot of the configuration is made through setting environment variables. See th
 ## Env
 
 ### docker-compose.env - basic variables
+```
 KOHA_BUILD     : the patched build of Koha, built in [[Patch Setup]]
 KOHA_VERSION   : The current tag of Koha base we build  on
 KOHA_IMAGE_TAG : Only used as basis for building koha_dev image [[Development Setup]]
 GITREF         : The git commmit ID used to identify image (locally or on Docker hub)
                  Only built from `master` branch
+```
 
 ### common.yml - mysql server and data volume
 We highly recommend using a separate container for mysql server and a Data volume for mysql data.
@@ -57,10 +59,25 @@ PIDGEON_PASS                  : Print notice password
 
 ### dev.yml - development setup
 
-sets up a koha git instance ready for development. Env vars :
+Workdir: `kohadev`
+
+Purpose: sets up a koha git instance ready for development. Exposes mysql on port 3306.
 
+Dockerfile: Uses a shallow clone of Koha-github repo and sets up development tools in `/kohadev`
+Sets up apache, plack and SIPserver to use code from git repo.
+
+ENV
 ```
 AUTHOR_NAME  : Bugzilla Name
 AUTHOR_EMAIL : Bugzilla email
 BUGZ_USER    : Bugzilla userid
-BUGZ_PASS    : Bugzilla password
\ No newline at end of file
+BUGZ_PASS    : Bugzilla password
+```
+
+### patched.yml - building a patched Koha
+
+workdir: `koha-patched`
+
+Purpose: build image for one-off containers to patch koha, run tests and produce .deb installation files for koha
+
+Dockerfile: mounts in local folders  `/debian` and `/patches` from workdir. Pulls and installs a Koha tag from github, applies patches in `/patches` folder, runs Koha unit tests and, if successful, builds debian packages ready for use in `/debian` folder. These can be added to an apt repo and used in normal package installs.
\ No newline at end of file