diff --git a/cookbooks/emerge/README.md b/cookbooks/emerge/README.md
new file mode 100644
index 000000000..d0de4e60e
--- /dev/null
+++ b/cookbooks/emerge/README.md
@@ -0,0 +1,37 @@
+= DESCRIPTION:
+
+Emerge Cookbook.  
+
+This cookbook holds 2 definitions, one called enable_package and one called update_file.  Between these two definitions it enables you to 'unmask' a package in Chef and then install an 'masked' version of said package.
+
+= USAGE:
+
+For example if you want to install Libxml 2.7.6 on the AppCloud you would use the following as a recipe.
+
+    enable_package "dev-libs/libxml2" do
+      version "2.7.6"
+    end
+
+    package "dev-libs/libxml2" do
+      version "2.7.6"
+      action :install
+    end
+
+= ALTERNATIVE USAGE:
+
+    enable_package "dev-lang/ruby" do
+      version "1.8.7_p299"
+    end
+
+    package_use "dev-lang/ruby" do
+      flags "threads"
+    end
+
+    package "dev-lang/ruby" do
+      version "1.8.7_p299"
+      action :install
+    end
+
+= LEGEND:
+
+Gentoo uses the names 'mask' and 'unmask' terminology between stable and unstable.  Typically this is done in /etc/make.conf with ACCEPT_KEYWORDS declaration for '~amd64' and '~x86'.  However it can also be added to /etc/portage/package.keywords/local to 'unmask' packages individually.
diff --git a/cookbooks/emerge/README.rdoc b/cookbooks/emerge/README.rdoc
deleted file mode 100644
index df591e004..000000000
--- a/cookbooks/emerge/README.rdoc
+++ /dev/null
@@ -1,37 +0,0 @@
-= DESCRIPTION:
-
-Emerge Cookbook.  
-
-This cookbook holds 2 definitions, one called enable_package and one called update_file.  Between these two definitions it enables you to 'unmask' a package in Chef and then install an 'masked' version of said package.
-
-= USAGE:
-
-For example if you want to install Libxml 2.7.6 on the AppCloud you would use the following as a recipe.
-
-	enable_package "dev-libs/libxml2" do
-	  version "2.7.6"
-	end
-
-	package "dev-libs/libxml2" do
-	  version "2.7.6"
-	  action :install
-	end
-
-= ALTERNATIVE USAGE:
-
-	enable_package "dev-lang/ruby" do
-	  version "1.8.7_p299"
-	end
-
-	package_use "dev-lang/ruby" do
-	  flags "threads"
-	end
-
-	package "dev-lang/ruby" do
-	  version "1.8.7_p299"
-	  action :install
-	end
-
-= LEGEND:
-
-Gentoo uses the names 'mask' and 'unmask' terminology between stable and unstable.  Typically this is done in /etc/make.conf with ACCEPT_KEYWORDS declaration for '~amd64 and ~x86".  However it can also be added to /etc/portage/package.keywords/local to 'unmask' packages individually.