diff --git a/spring-amqp-core/src/test/java/README.txt b/spring-amqp-core/src/test/java/README.txt
deleted file mode 100644
index 37c1a980..00000000
--- a/spring-amqp-core/src/test/java/README.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-Many of the "integration" tests here require a running RabbitMQ server.
-
-If RabbitMQ is not installed on your system, refer to the instructions for your
-particular OS here: http://www.rabbitmq.com/install.html
-
-Start the server. For example, and a *nix-based system where RabbitMQ has been
-installed within /opt/rabbitmq, issue the following command:
-> sudo /opt/rabbitmq/sbin/rabbitmq-server start
diff --git a/spring-rabbit/README.md b/spring-rabbit/README.md
new file mode 100644
index 00000000..f25a8644
--- /dev/null
+++ b/spring-rabbit/README.md
@@ -0,0 +1,10 @@
+Many of the "integration" tests here require a running RabbitMQ server - they
+will be skipped if the broker is not detected.
+
+If RabbitMQ is not installed on your system, refer to the instructions for your
+particular OS here: [http://www.rabbitmq.com/install.html]
+
+Start the server. For example, and a *nix-based system where RabbitMQ has been
+installed within `/opt/rabbitmq`, issue the following command:
+
+    > sudo /opt/rabbitmq/sbin/rabbitmq-server start