diff --git a/docs/dev-env-eclipse.md b/docs/dev-env-eclipse.md
new file mode 100644
index 00000000..5f882d72
--- /dev/null
+++ b/docs/dev-env-eclipse.md
@@ -0,0 +1,49 @@
+# Setting up your development environment using Eclipse
+
+The Maven Alfresco SDK is designed to work well with Eclipse. This support includes the ability to import existing Alfresco projects created using the 
+Alfresco SDK.
+
+Here we assume you already have an Eclipse installation up and running, together with an available Alfresco project created using the Alfresco SDK. If you 
+don't have a project already, follow the steps in [Getting started with Alfresco SDK 4.0](getting-started.md) to learn how to quickly generate it in a few 
+easy steps.
+
+## Importing the Alfresco project into Eclipse
+
+1. Starting from Eclipse, select `File > Import > Maven > Existing Maven Projects` from the main menu to import the Alfresco project.
+
+![Alt text](./imgs/sdk-dev-env-eclipse-import.png?raw=true "Eclipse maven project import")
+
+2. Click `Next` then browse to the root of the Alfresco project.
+
+![Alt text](./imgs/sdk-dev-env-eclipse-project.png?raw=true "Eclipse maven project selection")
+
+3. Click `Finish` to start importing the project into Eclipse.
+
+Before completing the import, Eclipse checks the completeness of the local Maven repository. If you already have a local repository that includes all the 
+required dependencies, this task will finish relatively quickly. Otherwise, be patient and wait until the downloads are completed (it can take some time).
+
+Once the import is complete, a warning message may be displayed.
+
+![Alt text](./imgs/sdk-dev-env-eclipse-warning.png?raw=true "Eclipse maven project import warning")
+
+4. Click `Resolve All Later` to complete the import task.
+
+5. Check the Markers tab in the bottom panel, where you may see some Maven problems. Expand the list and right click on a item with an error, then select 
+`Quick Fix` and mark as shown.
+
+![Alt text](./imgs/sdk-dev-env-eclipse-quickfix.png?raw=true "Eclipse maven project import quick fix")
+
+6. Click `Finish` to confirm the fix.
+
+You may be asked to confirm your selection.
+
+7. Repeat the fix for all similar issues you have. Note that these issues really depend on the archetype you used to generate the project.
+
+Once done, you may see an error with description: Project configuration is not up-to-date with pom.xml.
+
+8. To fix this, right click one of the Alfresco projects and select `Maven > Update Project`, ensure all the Alfresco projects and sub-projects are selected, 
+and then click `OK`.
+
+Once this is done, the project is successfully imported in Eclipse. 
+
+If you want more detail about how to work with the project, please visit [Working with generated projects](projects-usage.md).
diff --git a/docs/imgs/sdk-dev-env-eclipse-import.png b/docs/imgs/sdk-dev-env-eclipse-import.png
new file mode 100644
index 00000000..1a59064d
Binary files /dev/null and b/docs/imgs/sdk-dev-env-eclipse-import.png differ
diff --git a/docs/imgs/sdk-dev-env-eclipse-project.png b/docs/imgs/sdk-dev-env-eclipse-project.png
new file mode 100644
index 00000000..a3c50940
Binary files /dev/null and b/docs/imgs/sdk-dev-env-eclipse-project.png differ
diff --git a/docs/imgs/sdk-dev-env-eclipse-quickfix.png b/docs/imgs/sdk-dev-env-eclipse-quickfix.png
new file mode 100644
index 00000000..3af737d4
Binary files /dev/null and b/docs/imgs/sdk-dev-env-eclipse-quickfix.png differ
diff --git a/docs/imgs/sdk-dev-env-eclipse-warning.png b/docs/imgs/sdk-dev-env-eclipse-warning.png
new file mode 100644
index 00000000..e4068e1b
Binary files /dev/null and b/docs/imgs/sdk-dev-env-eclipse-warning.png differ