diff --git a/README.md b/README.md
index 8883f9b..e2aa945 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,38 @@
-# ansible-mikrotik
\ No newline at end of file
+Ansible MikroTik modules
+========================
+
+Introduction
+------------
+
+This repository provides Ansible modules to manage MikroTik RouterOS-based
+devices.
+
+Requirements
+------------
+
+At this time there are no external dependencies. However, there are additional
+Python modules that are required by the Ansible modules. You may find these in
+`pythonlibs`. Before using Ansible you should add these libraries to your
+Python path:
+`export PYTHONPATH="$PYTHONPATH:$PWD/pythonlibs"`
+
+Development
+-----------
+
+In order to test this module, you'll need a RouterOS instance to target. If you
+have an existing RouterOS-based MikroTik device, you need only make sure the
+API service is enabled.
+
+Otherwise, this repository provides a Vagrantfile for setting up the x86 build
+of RouterOS for testing. To use it, you must first ensure Vagrant and
+VirtualBox are installed. Then, run `./create_vagrant_mikrotik.sh` to download
+the official MikroTik Cloud Hosted Router (CHR) image from MikroTik, package
+it as a Vagrant .box file, and register the .box with Vagrant.
+
+Then, you need only run `vagrant up` in the repository root to start the CHR.
+
+Installing
+----------
+
+These modules are still in a very early stage of development; stay tuned for
+installation instructions later! :)