AF3-Developer-Installation.md

@@ -44,7 +44,7 @@ Installation Procedure
     - NOTE: The HOME variable is read by the git implementation of Eclipse. If it points to a network share, you will experience severe performance impacts, so choose a local folder instead!
 -   Download the [Eclipse Installer](https://www.eclipse.org/downloads/) and start it
     -  Be sure to get a recent version that bundles a JRE. Otherwise the installation may fail due to SSL certificate issues
-    - Tested with [2021-03 a.k.a 1.20.0 Build 5032](https://www.eclipse.org/downloads/packages/release/2021-03/r)
+    - Tested with [2021-06 a.k.a 1.21.0 Build 5141](https://www.eclipse.org/downloads/packages/release/2021-06/r)
     -  After starting, switch to *Advanced Mode* (“burger icon” in the upper-right corner)
 -   On the **Product** page select:
     -   Eclipse Modeling Tools
@@ -85,20 +85,16 @@ Installation Procedure
 -   On the **Product Variable** page:
     -   Check “Show all variables” at the bottom of this dialog page to
         see all options
-    -   Customize the installation locations or accept the default
-        (sub-folder to your user home)
--   Select **Next**
+    -   Customize the installation locations or accept the default (sub-folder to your user home)
+    -   Select **Next**
 -   You see a list of tasks that will be executed. Just hit **Finish**.
--   You will be asked to confirm licenses.
--   **NOTE**: If an error occurs that warns a certain plugin could not
-    be downloaded to the p2 cache (checksum), please select a different
-    p2 pool in the first page of the installer. Alternatively, you can
-    also delete the contents of the p2 pool , but beware: Old AutoFOCUS3
-    installations cannot be executed any more after doing this.
--   Wait until the projects are fully built and the IDE has updated the
+-   You will be asked to confirm licenses and software certificates.
+-   Start initial build (in Eclipse)
+    -   Enable auto build (*Project* Menu -> *Build Automatically*) and clean all projects (*Project -> Build Automatically*)
+    -   Wait until the projects are fully built and the IDE has updated the
     package explorer icons (you should see gray, red, yellow or green
     code rating bullets in the top-left corner of each project icon).
--   **NOTE**: If there are build errors after the compilation, ...
+-   **NOTE**: If there are build errors after the compilation (see *Problems* view), ...
     - ... clean (ONLY) the plugin “org.fortiss.tooling.kernel” such that the
     pseudo-errors disappear.
     - ... clean all plugins in the workspace.
@@ -112,20 +108,25 @@ Installation Procedure
     “Java” into the Quick Access" box in the top-right corner and
     clicking on the “Perspective” item in the list (Not the View!).
 
-**Note** that You can clean your installation by deleting the
-installation root folder.  
-However, you might want to keep the bundle pool.
-
 Starting AF3
 ------------
 
-Go to “Run >Run” or “Run >Debug” to start af3. You will be
-prompted to select a launch configuration. Select the one which matches
-your operating system and click ok.
+- Go to “Run >Run” or “Run >Debug” to start af3.
+- You will be prompted to select a launch configuration. Select the one which matches
+your operating system.
+- In the *Plug-ins* tab, hit *Add required Plug-Ins*, *Apply*, *Debug*/*Run*
+
+Notes on cleaning up
+--------------------
+- You can clean your installation by deleting the installation root folder. However, you might want to keep the bundle pool.
+- If the installation fails with error that a certain plugin could not
+  be downloaded to the p2 cache (checksum), please select a different
+  p2 pool in the first page of the installer. Alternatively, you can
+  also delete the contents of the p2 pool , but beware: Old AutoFOCUS3
+  installations cannot be executed any more after doing this.
 
 FAQ
 ---
-
 -   <u>Question</u>: Oomph installer cannot find update sites? (Problem
     occurred on Windows)  
     <u>Answer</u>: Deactivate proxy servers.