diff --git a/doc/iocs/creation/Create-Motor-IOC.md b/doc/iocs/creation/Create-Motor-IOC.md
new file mode 100644
index 000000000..0e87e6912
--- /dev/null
+++ b/doc/iocs/creation/Create-Motor-IOC.md
@@ -0,0 +1,14 @@
+# Creating a Motor IOC
+
+Here we will create a motor IOC from an existing IOC. Specifically, create an ESP300 IOC using the Newport IOC as a template.
+
+The motor is supported by the [newport module](https://github.com/epics-motor/motorNewport) and there are examples of usage in [the `iocBoot` directory](https://github.com/epics-motor/motorNewport/tree/master/iocs/newportIOC/iocBoot/iocNewport) and [startup scripts](https://github.com/epics-motor/motorNewport/tree/master/newportApp/iocsh) that need to be compared. Driver support is built into the Newport module.
+
+A search of `Newport` in our IOCs shows `CONEXAGP`  or `SMC100` as potential templates to follow. Unfortunately both of these are 
+model 3 motor drivers (they use asyn motor class and `asyn_motor.db`) whereas ESP300 is the older model 1 style (like Mclennan or Linmot), so the Db files and syntax to call the driver will be more like Mclennan/Linmot (`motor.db`).
+
+We will do a very basic implementation to start with as a proof of principle that it works
+
+* make a copy of SMC100 ioc tree and rename to ESP300
+* analyse the examples above to see what commands are needed to connect to the motor e.g. serial or ethernet
+* change Db include from `asyn_motor.db` to `motor.db`
diff --git a/doc/specific_iocs/Motors.md b/doc/specific_iocs/Motors.md
index 07fdfc65c..d4829f9c8 100644
--- a/doc/specific_iocs/Motors.md
+++ b/doc/specific_iocs/Motors.md
@@ -33,6 +33,10 @@ Motors will tend to have a subset of the following *.cmd files for loading dbs:
 | `st-motor.cmd` | Loads the actual db files for each individual axis | A single file in the first IOC |
 | `galilXX.cmd` | Sets up the physical connection for a Galil | A file for each galil in `configurations\galil` |
 
+## Creating a motor IOC
+
+see [Create Motor IOC](/iocs/creation/Create-Motor-IOC.md)
+
 ## Motors used at ISIS
 
 The motors currently used at ISIS are: