updated the update instructions

Author: jantje

website/WebContent/fragments/how_to/update.md

@@ -1,28 +1,31 @@
-How to update your plugin  
+How to update your plugin
 =========================
+**When you update the plugin you also have to update the workspace.**
 
-This update procedure works for all versions of the product.  
-
-When you are in Eclipse select `Help` -> `Check for updates`: the procedure will check for any available update for your Eclipse installation, including eclipse, egit, CDT, the Arduino Eclipse plugin and many more. 
-After that is done do the after update actions as described below. 
-
-Please **do not** download the new product version but use the update process via the update sites.
+How to do a major update  (V2.x to V3.y)
+==================
+A reinstall of the product is the only supported way.
+To save yourself a ton of downloads you can copy the [old eclipse install/arduioPlugin/downloads] to [new eclipse install/arduioPlugin/downloads]
+Only copy the downloads folder as the folder structure has changed and probably will change again.
 
-**V1 users:** note there will never be an update.
+How to do a minor update (V4.x to V4.y with x<y)
+==================
+When you are in Eclipse select `Help->Check for updates`: the procedure will check for any available update for your Eclipse installation, including eclipse, egit, CDT, gnuarm, Sloeber and many more.
 
-**V2 users:** Note that the nightly is V3 so a update with the nightly in your update sites will result in a upgrade to V3.
+If no sloeber update is found see wether the Sloeber update site is known and active in `windows->preferences->available update sites`. The site must be listed and a check must be in the checkbox.
 
-**V2 Product users:** note that with recent versions you will update to the nightly build. If you do not want that remove the nightly build from your update sites.
+The update site should be like http://eclipse.baeyens.it/update/V[major version number]/stable for instance http://eclipse.baeyens.it/update/V4/stable
 
-After this do the **after update actions**
 
- How to update the arduino ide version (not applicable for V3)  
-========================= 
-Install the arduino IDE as you would do usually.  
-After this do the **after update actions**
+ How to update the arduino ide version (for V1 and V2 users only)
+=========================
+Install the arduino IDE as you would do usually.
 
-after update actions
+Workspace update actions
 ==================
+For each and every project go to the `project properties->arduino`. Verify your settings.  **Select apply and close.**
+Note that it is not "abnormal" that after a update the data in  `project properties->arduino` is wrong.
+
 **V1 to V2 actions** Open 2 eclipse instances 1 pointing to your old workspace one pointing to your new workspace.
 Setup the new workspace so it knows all hardware and libraries you need.
 For each project in the old workspace; create a new projects and drag and drop your code from the old workspace/project to the new workspace/project. Do not copy core or library code.
@@ -31,15 +34,11 @@ For each project in the old workspace; create a new projects and drag and drop y
 
 I'm not saying these steps should be done after each and every upgrade. However if something does not seem to work these are the first steps to do.
 
-In V1 and V2 look at the general preferences and make sure it points to the "correct" arduino IDE.  
+In V1 and V2 look at the general preferences and make sure it points to the "correct" arduino IDE.
 **Select apply and close.**
 
-All versions: For each and every project go to the project properties->arduino. Verify your settings.  **Select apply and close.**
 
-Note that it is not "abnormal" that after a update -of the plugin or the arduino IDE- the data in the preferences->arduino or project properties-arduino is completely wrong. 
-
- 
  **Party success**
- 
+
  1. drink a beer
  2. [Become a patron of jantje](http://eclipse.baeyens.it/donate.html "thanks")