diff --git a/README.md b/README.md
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..d600b7dc97e039fca4ffdd262c22235e6e450972 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,61 @@
+Vtiger CRM
+==========
+
+Vtiger is a PHP based web application that helps businesses manage their sales and marketing processes.
+
+Development on vtiger is done at http://code.vtiger.com which is a gitlab server.
+
+To register for an account, please contact info @ vtiger.com, you will need this to file issues and/or fix the code
+Once you have an account, you can [browse the code](http://code.vtiger.com/vtiger/vtigercrm/tree/master),
+[see if your issue is already reported](http://code.vtiger.com/vtiger/vtigercrm/issues) and if you have a new problem
+to report you can [create an issue](http://code.vtiger.com/vtiger/vtigercrm/issues/new?issue)
+
+If you then want to fix the issue (or another issue) you can create your own fork of vtiger to work on using the
+fork button on the vtiger project, this will create a new git repository for you at
+    
+    http://code.vtiger.com/yourname/vtigercrm.git
+
+on your computer you will need a git client installed and you need to tell git who you are:
+
+    git config --global user.name "YOUR NAME"
+    git config --global user.email "YOUR EMAIL ADDRESS"
+
+now clone your fork of vtiger
+
+    git clone http://code.vtiger.com/yourname/vtigercrm.git
+
+this will pull down from the server your copy of the vtiger code and all the history.
+
+You will make a new branch for your changes, you can give it a descriptive name, once the branch is created
+you will switch to that branch using the checkout command
+
+    git branch fix_projects_on_calendar
+    git checkout fix_projects_on_calendar
+
+Now you can make your changes and commit all changed files with
+
+    git commit -a
+
+Do reference the issue number in your commit message, e.g. "fix #2 display projects on the calendar" the number will
+allow the system to link the commit to the issue.
+
+Now you can push your branch to the server, this creates the branch on the server end and populates it
+
+    git push --set-upstream origin fix_projects_on_calendar
+
+look at the branch on code.vtiger.com and create a merge request from your branch
+to the upstream master, this will be reviewed to see if it fixes the 
+issue and if all is good will be merged into the upstream code.
+You can then switch back to your master branch with
+
+    git checkout master
+
+And you can create additional feature branches from there to fix different things.
+
+If there have been other changes to the central vtiger code that you want in your work area then you can add the central
+repository as an upstream remote (only need to do this bit once), then you can fetch changes and merge them
+
+    git remote add upstream http://code.vtiger.com/vtiger/vtigercrm.git
+    git fetch upstream
+    git merge upstream/master
+