diff --git a/readme b/readme
deleted file mode 100644
index 21507de..0000000
--- a/readme
+++ /dev/null
@@ -1,15 +0,0 @@
-Shockrah's Dockerfiles
-----------------------
-
-This repository serves as a collection of Dockerfiles which I use for various 
-projects that I either maintain or have worked on in this past.
-
-All relate to _my_ projects and are not reflective of other peoples works.
-
-Email: alejandros714@protonmail.com
-
-> Pipelines
-
-The pipelines setup here are really just for testing small things so that 
-I don't waste time on larger projcets troubleshooting issues. In other words:
-the pipelines setup here are of no importance
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..b2e7d00
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,27 @@
+# Shockrah's Dockerfiles
+
+This repository serves as a place of consolidation for most of the major public
+docker images that I maintain. 
+
+# Update Cycle
+
+I mostly update these for my own sake however special versioning cycles can be
+arranged for those that that request it.
+
+Email: `dev@shockrah.xyz`
+
+
+# Contributing
+
+There are really two rules for contributing:
+
+* Be explicit in you descriptions of what is being contributed
+
+State what the contribution is and why it's being proposed. Some contributions
+may not be appropriate for a mainline release of an image however it may be
+suitable for an alternate release which can always be arranged.
+
+* Don't be a complete ass
+
+_Please don't make me explain this one_.
+