diff --git a/README.md b/README.md
index 5487b8f0dae58a480af02dd934c588893e444e9e..4945dd1b586a3bc0311afcdb586cc4eada878f03 100644
--- a/README.md
+++ b/README.md
@@ -29,18 +29,19 @@ Note: in general, the expectation is that environment variables with names start
 
 Share location
 ==============
-* set WPKGSOFTWARE=\\ifs.ch.private.cam.ac.uk\deploy\software
-* set WPKGSHAREBASE=\\ifs.ch.private.cam.ac.uk\deploy
+* `set WPKGSOFTWARE=\\ifs.ch.private.cam.ac.uk\deploy\software`
+* `set WPKGSHAREBASE=\\ifs.ch.private.cam.ac.uk\deploy`
 
 Institute codes
-==============
-1. chemistry  
-Department of Chemistry
-2. maths  
-Faculty of Mathematics
+===============
+See https://gitlab.developers.cam.ac.uk/ch/co/ucam_wpkg/-/wikis/Institude-codes
 
 Repository layout
 ================
 
-\packages - directory with multiple xml files, each of corresponds to an individual WPKG package definition
-\scripts - example scripts, e.g. wrappers around wpkg.js which map drives and set environment variables
+* packages: directory with multiple xml files, each of corresponds to an individual WPKG package definition
+* packages\wpkg\tools: scripts which are called from wpkg definition
+* miscscripts: example scripts, e.g. wrappers around wpkg.js which map drives and set environment variables
+
+* common-config: config files that are used in a wpkg for all institutions
+* %WPKGINSTITUTION%-config: config files specific to a particlar institution.