diff --git a/README.md b/README.md
index 7137560d..adc73570 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,74 @@
 [![CircleCI](https://circleci.com/gh/micromdm/micromdm/tree/master.svg?style=svg)](https://circleci.com/gh/micromdm/micromdm/tree/master)
 
-MircoMDM is a Mobile Device Management server for Apple Devices (primarily OS X macs).
+MicroMDM is a Mobile Device Management server for Apple Devices (primarily macOS devices).
 
-Note: We are making some changes. The README will be updated shortly. 
+# Introduction 
+
+MDM is a large domain, and we are looking at how to solve many problems with device management. However, at this stage of development we're focusing on a very specific use case which is current to many Mac Administrators: 
+
+> When a device enrolls(through DEP or otherwise) we want to bootstrap some tools to manage the mac. These are agents running on a mac like Munki or Chef/Puppet which will manage the software and configuration through the lifecycle of the mac. 
+
+MicroMDM, today is able to solve this common use-case, and we're focusing on improving the user experience for administrators and developing related features.
+
+MicroMDM is being actively developed but is **ready for you to start testing**. 
+
+To get started, see the [Quickstart](https://github.com/micromdm/micromdm/wiki/Quickstart) tutorial on the wiki. 
+
+# Install
+
+Unless you're a developer, you probably want a binary you can run. [Download](https://github.com/micromdm/micromdm/releases/latest) the latest release, 
+either for macOS(darwin) or linux. 
+
+
+# Getting Help
+
+The best place to get help is the `#micromdm` channel on the MacAdmins Slack. [[invite link](https://macadmins.herokuapp.com/)]
+
+# Helping Us
+
+Over the last year this project has gained a lot of interest from the community. We want to make it clear that at this point MicroMDM is a passion project, and is being developed by a [few fellow Mac Admins](https://github.com/micromdm/micromdm/graphs/contributors) on weekends and during conference hackathons. 
+
+It would be great to get a few more developers to contribute, but at this point, there are _more_ important tasks than knowing how to code.
+Here is how you can help: 
+
+- Read the documentation, install the tool and test MicroMDM.   
+- File bugs: https://github.com/micromdm/micromdm/issues  
+- Participate in discussions. The `#micromdm` slack channel is best, but `#mdm` and `#dep` are a few relevant ones.   
+- Edit the Wiki: https://github.com/micromdm/micromdm/wiki  
+The wiki page is open to anyone and you can make a lot of impact on the project by submitting additional documentation or even design proposals.
+
+- Were you able to set up MicroMDM and enroll a few devices? Try blogging about your experience. 
+It can help others get started, or can help us figure out what we need to do better.
+
+# Design Goals
+
+As mentioned in the introduction, we are working on trying to solve the use case of bootstraping Macs. That's the short term (from now until WWDC). 
+But there's a larger design goal we have in mind - what will differentiate MicroMDM from other vendor projects. Here it is in brief:
+
+- MicroMDM aims to provide a declarative approach to device management. Too often vendor tools expect you to manage devices by filling out various forms in a web interface. While MicroMDM might have a web interface of it's own one day, the tool itself is inspired by popular DevOps processes like Configuration Management(chef/puppet/ansible,terraform) and orchestration frameworks(Kubernetes, Docker). 
+For example here is a process of applying a DEP profile: 
+```
+$ micromdm apply dep-profile -f /tmp/profile.json
+updated profile CDACFE6013F926F5.
+
+$ micromdm get dep profile -uuid=CDACFE6013F926F5
+{
+  "profile_name": "Test Profile",
+  "url": "https://mdm.acmeinc.com/getconfig",
+  "is_mdm_removable": true,
+  "support_phone_number": "1-555-555-5555",
+  "support_email_address": "org-email@example.com",
+  "org_magic": "913FABBB-0032-4E13-9966-D6BBAC900331",
+  "skip_setup_items": [
+    "Registration",
+    "AppleID",
+    "TOS"
+  ]
+}
+``` 
+
+- Expose an API for developers and administratos. Today you can send MDM commands to the server using a RESTful API. We intend to make more processes scriptable. 
+
+- Provide a way for administrators to subscribe to events. MicroMDM works through a pubsub system at it's core. For example, when a new device enrolls into the MDM, the server doesn't record this in the database immediately, but instead creates an event which is sent on a message bus to other services. Today, this message bus is built in-memory, but we plan to expose the same hooks over the network, allowing developers to consume events in any language - not just Go.
+
+[Here](https://docs.google.com/drawings/d/1B4w5xOmU-7D5pcW0kdiY7ia5fl7UnBfRpWR8KxzD1YI/edit?usp=sharing) is a slightly more in depth design overview of the pubsub system within MicroMDM.