From 03fde1cc52044a83396746297eca308f9d43b0e0 Mon Sep 17 00:00:00 2001
From: Christian Huffman <chuffman@redhat.com>
Date: Tue, 23 Oct 2018 18:41:45 -0400
Subject: [PATCH] WINDUP-2245: Included instructions for installing JBoss
 Tools.

---
 docs/plugin-guide/master.adoc        |  2 ++
 docs/topics/install-jboss-tools.adoc | 17 +++++++++++++++++
 docs/topics/plugin-install.adoc      |  4 ++++
 3 files changed, 23 insertions(+)
 create mode 100644 docs/topics/install-jboss-tools.adoc

diff --git a/docs/plugin-guide/master.adoc b/docs/plugin-guide/master.adoc
index ec93283d72..eb38bf5e04 100644
--- a/docs/plugin-guide/master.adoc
+++ b/docs/plugin-guide/master.adoc
@@ -70,6 +70,8 @@ include::topics/eclipse-submit-ruleset.adoc[leveloffset=+2]
 
 include::topics/plugin-icon-legend.adoc[leveloffset=+2]
 
+include::topics/install-jboss-tools.adoc[leveloffset=+2]
+
 // **********************************
 // * Appendix: Revision Information *
 // **********************************
diff --git a/docs/topics/install-jboss-tools.adoc b/docs/topics/install-jboss-tools.adoc
new file mode 100644
index 0000000000..b5da62acb1
--- /dev/null
+++ b/docs/topics/install-jboss-tools.adoc
@@ -0,0 +1,17 @@
+[[install_jboss_tools]]
+= Install JBoss Tools into Eclipse
+
+The {PluginNameTitle} depends on JBoss Tools, and therefore these dependencies must be installed for {ProductShortName} to function successfully. The following instructions detail installing JBoss Tools on an Eclipse installation.
+
+.Install JBoss Tools
+
+. From the menu bar, select *Help* -> *Eclipse Marketplace*. 
+. In the *Find* field, enter `JBoss Tools` and press *Enter* to search for the project.
+. Scroll down until you see *JBoss Tools* in the list and press *Install* next to this project.
+. Review the selected features and press *Confirm*. It is recommended to accept the defaults to install the required dependencies for {ProductShortName}.
+. Ensure that the first radio button, `Keep my installation the same and modify the items being installed to be compatible`, is selected.
+. Review the selected packages and click *Confirm*.
+. Accept the terms of the license agreement and click *Finish*.
+. Click *Install anyway* to accept the certificates.
+. Click *Select all* to trust all of the specified certificates, and then click *Accept selected*.
+. Restart Eclipse for the changes to take effect.
diff --git a/docs/topics/plugin-install.adoc b/docs/topics/plugin-install.adoc
index c7c6542c58..01fc3087fc 100644
--- a/docs/topics/plugin-install.adoc
+++ b/docs/topics/plugin-install.adoc
@@ -9,6 +9,10 @@ If you do not already have an existing installation, download link:http://www.ec
 
 NOTE: This guide uses _Eclipse_ to refer to an installation of Eclipse or JBoss Developer Studio.
 
+.Prerequisites
+
+* If you are using Eclipse, and not JBoss Developer Studio, then you must xref:install_jboss_tools[install JBoss Tools] before installing the {PluginNameTitle}.
+
 .Install the Plugin
 
 . Launch Eclipse.