Revise developer instructions for local build and run

Updated instructions for building and running OIE locally, emphasizing the Docker approach and providing additional context for users.

Signed-off-by: Jon Bartels <[email protected]>

Author: jonbartels

DEVELOPERS.md

@@ -1,24 +1,16 @@
 # For developers and contributors
 
-You can build and run OIE locally, or using Docker.  For full documentation see [docs.openintegrationengine.org](https://docs.openintegrationengine.org/engine/contributing.html).
+This document is for developers who want to make modifications to OIE. If you are a user who wants to run and use OIE, please review [the README](./README.md) or the full documentation see [docs.openintegrationengine.org](https://docs.openintegrationengine.org/engine/contributing.html).
 
-## Local Build and Run
+There are two ways to build and run OIE locally. The reccommended way is to use Docker. OIE can also be run with traditional build tools. 
 
-```bash
-# Install dependencies manually or use https://sdkman.io/
-sdk env install
+Both are described here. We suggest the Docker approach for most use cases.
 
-# Build the server
-# NOTE: Building will delete any existing server configuration!
-ant -f server/mirth-build.xml -DdisableSigning=true
+For either approach we also strongly suggest using a launcher. The preferred launcher is [Ballista](https://github.com/kayyagari/ballista) but the Bridge Link launcher and the NextGen Mirth Connect Admin Launcher are known to work.
 
-# Run the server
-server/setup/oieserver
-
-# Connect using Ballista or another launcher at https://localhost:8443
-```
+## Local Build and Run Using Docker 
 
-## Or Using Docker
+This is the preferred approach. The Docker image in the `engine` repository is maintained with the correct JDK, build steps, and best practices. 
 
 ```bash
 # Build using docker
@@ -30,3 +22,20 @@ docker run --rm -p 8443:8443 oie-dev
 
 # Connect using Ballista or another launcher at https://localhost:8443
 ```
+## Local Build and Run using Ant
+
+This is the older, traditional approach from the now closed-source Mirth Connect project. OIE is working to modernize the build system. The Docker approach is likely to be faster and more reliable and better supported.
+
+```bash
+# Install dependencies manually or use https://sdkman.io/
+sdk env install
+
+# Build the server
+# NOTE: Building will delete any existing server configuration!
+ant -f server/mirth-build.xml -DdisableSigning=true
+
+# Run the server
+server/setup/oieserver
+
+# Connect using Ballista or another launcher at https://localhost:8443
+```