diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 15e66eb2..36f90aae 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -52,7 +52,7 @@ The [Eclipse IDE for RCP developers](https://www.eclipse.org/downloads/packages/
### How do I open the projects in Eclipse IDE?
-The projects can be imported from Eclipse IDE:
+The easiest way is to import Pitclipse's project set as described in the [README](README.md#Contributing). The projects can although be imported manually:
1. `File` > `Import...`
2. `Existing Projects into Workspace`
diff --git a/README.md b/README.md
index bc05e944..e5f4276b 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,36 @@
-# Pitclipse
+
+ 
+ Pitclipse
+
+
+ Test your tests right into your IDE!
+
+
+
[](https://travis-ci.com/pitest/pitclipse) [](https://sonarcloud.io/dashboard?id=org.pitest%3Aorg.pitest.pitclipse) [](https://sonarcloud.io/dashboard?id=org.pitest%3Aorg.pitest.pitclipse) [](https://sonarcloud.io/dashboard?id=org.pitest%3Aorg.pitest.pitclipse) [  ](https://bintray.com/kazejiyu/Pitclipse/releases/_latestVersion)
-Provides support for [PIT (Pitest)](http://pitest.org) within the Eclipse IDE. Allows to compute the mutation coverage of your code and shows the result within dedicated views.
+
+
+Provides mutation coverage for your Java programs within the Eclipse IDE. Built on [PIT (Pitest)](http://pitest.org) for reliability.
+
+## What is mutation testing?
-## How to use Pitclipse?
+> Faults (or mutations) are automatically seeded into your code, then your tests are run. If your tests fail then the mutation is killed, if your tests pass then the mutation lived.
+>
+> The quality of your tests can be gauged from the percentage of mutations killed.
+>
+> *Henry Coles, [pitest.org](https://pitest.org)*
-First of all, you need to install Pitclipse in your Eclipse IDE (see `Installation` below).
+## Main Features
-Once the plug-in is installed, you can run Pitest:
+- **Reliability**: relies on [PIT (Pitest)](http://pitest.org)
+- **Customization**: provides numerous preferences to tailor analysis
+- **JUnit support**: works with both JUnit 4 and JUnit 5 tests
+
+## Usage
+
+Once the plug-in is installed (see [Installation](#Installation) below), you can run Pitest:
- Right-click on a Java project defining unit tests
- `Run As` > `PIT Mutation Test`
@@ -26,8 +48,6 @@ Preferences also allow to change mutation settings (`Window > Preferences > Pite
## Installation
-### From the Eclipse Marketplace
-
The plug-in is available in the [Eclipse Marketplace](https://marketplace.eclipse.org/content/pitclipse).
Drag the following button to your running Eclipse workspace to start the installation:
@@ -35,42 +55,54 @@ Drag the following button to your running Eclipse workspace to start the install
-### From the update site
-Alternatively, the plug-in can also be installed from the following (temporary) update site:
-
-- [https://dl.bintray.com/kazejiyu/Pitclipse/updates/](https://dl.bintray.com/kazejiyu/Pitclipse/updates/)
+
+ Or show how to install it manually
-To use it from Eclipse IDE, click on `Help` > `Install new software...` and then paste the above URL.
+ 1. Open Eclipse IDE
+ 2. Go to *Help > Install New Software...*
+ 3. Copy the update site’s URL in the *Work with* textbox:
+ - https://dl.bintray.com/kazejiyu/Pitclipse/updates/
+ 4. Hit *Enter* and wait for the list to load
+ 5. Check everything
+ 6. Click *Next* then *Finish*
+
-## How to contribute?
+## Contributing
-### Requirements
+
+ Requirements
-You will need [Maven 3.x](https://maven.apache.org/download.cgi), [Java 8 JDK](https://adoptopenjdk.net/upstream.html) and the latest [Eclipse IDE for RCP](https://www.eclipse.org/downloads/packages/) release.
+ - [Maven 3.x](https://maven.apache.org/download.cgi)
+ - [Java 8 JDK](https://adoptopenjdk.net/upstream.html)
+ - [Eclipse IDE for RCP](https://www.eclipse.org/downloads/packages/) (latest release)
+
-### Setup the environment
+
+ Import the projects in the IDE
-First of all, clone the repository:
+ 1. *File > Import... > Team > Team Project Set*
+ 2. Fill *URL* with "https://raw.githubusercontent.com/pitest/pitclipse/master/eclipse-project-set.psf"
+ 3. Click on *Finish*
-```
-git clone https://github.com/pitest/pitclipse.git
-```
+ > Tip: use Working Sets for a better workspace organization:
+ > - Open *Project Explorer*'s menu > *Top Level Elements* > *Working Sets*
+ > - Open *Project Explorer*'s menu > *Select Working Sets* > Check "bundles", "features", "tests" and "releng"
+
-Then:
+
+ Setup the environment
-1. Import all the plug-ins within your Eclipse IDE workspace
-2. Open the `releng/org.pitest.pitclipse.target/org.pitest.pitclipse.target.target` file
-3. Click on "_Set as Active Target Platform_"
-4. Wait for the dependencies to be loaded (may take a while)
-5. Open the `pom.xml` in the project `org.pitest`, navigate to the `` element marked with error, use the menu "Edit" > "Quick Fix" and select "Discover new m2e connectors"; in the dialog select `maven-dependency-plugin` and press "Finish"; conclude the installation procedure and restart Eclipse when prompted
-6. Use the menu "Project" > "Clean" and clean all projects; you should now have an error free workspace.
+ 1. Open the `org.pitest.pitclipse.target/org.pitest.pitclipse.target.target` file
+ 2. Click on *Set as Target Platform*
+ 3. Wait for the dependencies to be loaded (may take a while)
+
-### Commit your changes
+
+ Commit your changes
-Make your changes, then make sure the tests still pass:
-```
-mvn clean verify
-```
-Commit your changes, then submit a PR.
+ 1. Make some changes
+ 2. Make sure tests still pass: `mvn clean verify`
+ 3. Submit a PR
+
-> See [CONTRIBUTING.md](CONTRIBUTING.md) for further details.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for further details.
\ No newline at end of file
diff --git a/eclipse-project-set.psf b/eclipse-project-set.psf
new file mode 100644
index 00000000..893d062d
--- /dev/null
+++ b/eclipse-project-set.psf
@@ -0,0 +1,49 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+