MTA-3573: Explain reason for potential false positives

Signed-off-by: A.Arnold <[email protected]>

Author: anarnold97

docs/topics/mta-7-installing-web-console-on-openshift.adoc

@@ -9,7 +9,7 @@
 
 You can install the {ProductName} ({ProductShortName}) {WebName} on all Red Hat OpenShift cloud services and Red Hat OpenShift self-managed editions.
 
-IMPORTANT: To be able to create {ProductShortName} instances, you must first install the {ProductShortName} Operator.	
+IMPORTANT: To be able to create {ProductShortName} instances, you must first install the {ProductShortName} Operator.
 
 The {ProductShortName} Operator is a structural layer that manages resources deployed on OpenShift, such as database, front end, and back end, to automatically create an {ProductShortName} instance.
 
@@ -161,7 +161,7 @@ The most commonly used CR settings are listed in this table:
 |====
 +
 .Example YAML file
-[sample,YAML]
+[source,YAML]
 ----
 kind: Tackle
 apiVersion: tackle.konveyor.io/v1alpha1

docs/topics/mta-web-assessing-apps.adoc

@@ -21,9 +21,9 @@ IMPORTANT: You can assess only one application at a time.
 .Procedure
 
 . In the {ProductShortName} user interface, select the *Migration* view.
-. Click *Application inventory* in the left menu bar. A list of the available applications appears in the main pane. 
+. Click *Application inventory* in the left menu bar. A list of the available applications appears in the main pane.
 . Select the application you want to assess.
-. Click the *Options* menu ({kebab}) at the right end of the row and select *Assess* from the drop-down menu. 
+. Click the *Options* menu ({kebab}) at the right end of the row and select *Assess* from the drop-down menu.
 . From the list of available questionnaires, click *Take* for the desired questionnaire.
 . Select *Stakeholders* and *Stakeholder groups* from the lists to track who contributed to the assessment for future reference.
 +
@@ -33,6 +33,26 @@ NOTE: You can also add *Stakeholder Groups* or *Stakeholders* in the *Controls*
 . Answer each *Application assessment* question and click *Next*.
 . Click *Save* to review the assessment and proceed with the steps in xref:mta-web-reviewing-apps_user-interface-guide[Reviewing an application].
 
+[NOTE]
+====
+
+If you are seeing false positives in an application that is not fully resolvable, then this is not entirely unexpected.
+
+
+The reason, is that {ProductShortName} cannot discover the class is that is being called. Therefore, {ProductShortName} cannot determine whether it is a valid match or not.
+
+
+When this happens, {ProductShortName} defaults to exposing more information than less.
+
+
+In this situation, the following solutions are suggested:
+
+. Ensure that the maven settings can get all the dependencies.
+
+. Ensure the application is fully compilable.
+
+====
+
 [role="_additional-resources"]
 .Additional resources
 * xref:mta-default-questionnaire_user-interface-guide[The default assessment questionnaire]