diff --git a/compiler/cpp/src/audit/readme.txt b/compiler/cpp/src/audit/readme.txt
deleted file mode 100644
index f1c53e3..0000000
--- a/compiler/cpp/src/audit/readme.txt
+++ /dev/null
@@ -1,32 +0,0 @@
-Typical usage:
-    thrift.exe --audit <oldFile> <newFile>
-Example run:
-    > thrift.exe --audit test.thrift break1.thrift
-    [Thrift Audit Failure:break1.thrift] New Thrift File has missing function base_function3
-    [Thrift Audit Warning:break1.thrift] Constant const3 has different value
-
-Problems that the audit tool can catch:
-Errors
-    Removing an enum value
-    Changing the type of a struct field
-    Changing the required-ness of a struct field
-    Removing a struct field
-    Adding a required struct field
-    Adding a struct field 'in the middle'.  This usually indicates an old ID has been recycled
-    Struct removed
-    Oneway-ness change
-    Return type change
-    Missing function
-    Missing service
-    Change in service inheritance
-Warnings
-    Removing a language namespace declaration
-    Changing a namespace
-    Changing an enum value's name
-    Removing an enum class
-    Default value changed
-    Struct field name change
-    Removed constant
-    Type of constant changed
-    Value of constant changed
-    
\ No newline at end of file
diff --git a/test/audit/README.md b/test/audit/README.md
new file mode 100644
index 0000000..412f8d5
--- /dev/null
+++ b/test/audit/README.md
@@ -0,0 +1,40 @@
+Typical usage
+=============
+```
+thrift.exe --audit <oldFile> <newFile>
+```
+Example run
+===========
+```
+> thrift.exe --audit test.thrift break1.thrift
+[Thrift Audit Failure:break1.thrift] New Thrift File has missing function base_function3
+[Thrift Audit Warning:break1.thrift] Constant const3 has different value
+```
+
+Problems that the audit tool can catch
+======================================
+Errors
+* Removing an enum value
+* Changing the type of a struct field
+* Changing the required-ness of a struct field
+* Removing a struct field
+* Adding a required struct field
+* Adding a struct field 'in the middle'.  This usually indicates an old ID has been recycled
+* Struct removed
+* Oneway-ness change
+* Return type change
+* Missing function
+* Missing service
+* Change in service inheritance
+
+Warnings
+* Removing a language namespace declaration
+* Changing a namespace
+* Changing an enum value's name
+* Removing an enum class
+* Default value changed
+* Struct field name change
+* Removed constant
+* Type of constant changed
+* Value of constant changed
+    
\ No newline at end of file