diff --git a/plugins/ubuntu/readme.md b/plugins/ubuntu/readme.md
new file mode 100644
index 000000000..5954ead0e
--- /dev/null
+++ b/plugins/ubuntu/readme.md
@@ -0,0 +1,23 @@
+This plugin was created because the aliases in the debian plugin are inconsistent and hard to remember. Also this apt-priority detaction that switched between apt-get and aptitude was dropped to keep it simpler. This plugin uses apt-get for everything but a few things that are only possible with aptitude I guess. Ubuntu does not have aptitude installed by default.
+
+The aliases for this plugin are easy to remember because they are consistent (the debian plugin is not). 
+
+acs = **a**pt-**c**ache **s**earch  
+acp = **a**pt-**c**ache **p**olicy
+
+ag  = sudo **a**pt-**g**et  
+agi = sudo **a**pt-**g**et **i**nstall  
+agd = sudo **a**pt-**g**et **d**select-upgrade  
+By now you already can guess almost all aliases  
+
+There are two exeptions since ...  
+agu  = sudo **a**pt-**g**et **u**pdate  - we have ...  
+agug = sudo **a**pt-**g**et **u**pgrade - as the exeptional 4 letter alias for a single command.
+
+afs = **a**pt-**f**ile **s**earch --regexp - this has the regexp switch on without being represented in the alias, I guess this makes sense since the debian plugin has it, I never used that command.
+
+Then there are the 2 other 4 letter aliases for combined commands, that are straight forward and easy to remember.  
+aguu = sudo **a**pt-**g**et **u**pdate && sudo apt-get **u**pgrade      - better then adg or not?  
+agud = sudo **a**pt-**g**et **u**pdate && sudo apt-get **d**ist-upgrade
+
+For a full list aliases and the functions just watch the plugins code https://github.com/robbyrussell/oh-my-zsh/blob/master/plugins/debian/debian.plugin.zsh, look at the comments if you want to switch from the debian plugin. Ubuntu, Mint and & co users will like the new aar function to install packages from ppas with a single command.