diff --git a/LimnoriaChan/README.md b/LimnoriaChan/README.md
new file mode 100644
index 0000000..380d851
--- /dev/null
+++ b/LimnoriaChan/README.md
@@ -0,0 +1,9 @@
+# LimnoriaChan
+
+LimnoriaChan is meant for use on #Limnoria and is loaded on Limnoria there.
+
+# Usage
+
+LimnoriaChan has two commands called "issue" and "issuepl". Issue opens an issue to [Limnorias issue traker] and issuepl to [issue tracker of ProgVals Supybot-plugins].
+
+LimnoriaChan also includes factoids and ability to get issue links. They can be get by saying e.g %%issue#123 on channel, which returns https://github.com/ProgVal/Limnoria/pull/123 , or e.g %%git , which returns the git clone URL for Limnoria, git://github.com/ProgVal/Limnoria.git .
diff --git a/LimnoriaChan/README.txt b/LimnoriaChan/README.txt
deleted file mode 100644
index d60b47a..0000000
--- a/LimnoriaChan/README.txt
+++ /dev/null
@@ -1 +0,0 @@
-Insert a description of your plugin here, with any notes, etc. about using it.