Merge pull request #6 from migtools/MTA-2720_archetype-assessment

[WIP] Adding procedure on archetype review and assessment

Author: raoradhika

docs/topics/mta-web-archetypes.adoc

@@ -7,7 +7,7 @@
 [id="mta-archetypes_{context}"]
 = Working with archetypes
 
-An *archetype* is a group of applications with common characteristics. You can use archetypes to assess multiple applications at once. By using archetypes, the {ProductName} ({ProductShortName}) can apply questionnaires populated with questions that apply to common application characteristics.
+An *archetype* is a group of applications with common characteristics. You can use archetypes to assess multiple applications at once.
 
 Application archetypes are defined by criteria tags and the application taxonomy. Each archetype defines how the _assessment module_ assesses the application according to the characteristics defined in that archetype. If the tags of an application match the criteria tags of an archetype, the application is associated with the archetype.
 

docs/topics/proc_assessing-an-archetype.adoc

@@ -0,0 +1,23 @@
+:_newdoc-version: 2.18.2
+:_template-generated: 2024-06-26
+:_mod-docs-content-type: PROCEDURE
+
+[id="assessing-an-archetype_{context}"]
+= Assessing an archetype
+
+An archetype is considered assessed when all required questionnaires have been answered.
+
+NOTE: If an application is associated with several archetypes, this application is considered assessed when all associated archetypes have been assessed. 
+
+.Prerequisites
+
+* You are logged in to an {ProductShortName} server. 	
+
+.Procedure
+
+. Open the {ProductShortName} web console.
+. Select the *Migration* view and click Archetype.
+. Click the *Options* menu ({kebab}) and select *Assess* from the drop-down menu.
+. From the list of available questionnaires, click *Take* to select the desired questionnaire.
+. In the *Assessment* menu, answer the required questions.
+. Click *Save*.

docs/topics/proc_defining-an-archetype.adoc

@@ -6,7 +6,7 @@
 = Creating an archetype
 
 [role="_abstract"]
-When you create an archetype, an application in the inventory is automatically associated to that archetype if this application has the tags that match the tags of the archetype.
+When you create an archetype, an application in the inventory is automatically associated to that archetype if this application has the tags that match the criteria tags of the archetype.
 
 .Procedure
 

docs/topics/proc_deleting-an-archetype.adoc

@@ -6,4 +6,4 @@
 = Deleting an archetype
 
 [role="_abstract"]
-Deleting an archetype deletes any associated assessment. All associated applications move to the *Unassessed* state.
+Deleting an archetype deletes any associated assessment and review. All associated applications move to the *Unassessed* and *Unreviewed* state.

docs/topics/proc_reviewing-an-archetype.adoc

@@ -0,0 +1,31 @@
+:_newdoc-version: 2.18.2
+:_template-generated: 2024-06-26
+:_mod-docs-content-type: PROCEDURE
+
+[id="reviewing-an-archetype_{context}"]
+= Reviewing an archetype
+
+An archetype is considered reviewed when it has been reviewed once even if multiple questionnaires have been marked as required. 
+
+NOTE: If an application is associated with several archetypes, this application is considered reviewed when all associated archetypes have been reviewed. 	
+
+.Prerequisites
+
+* You are logged in to an {ProductShortName} server. 	
+
+.Procedure
+
+. Open the {ProductShortName} web console.
+. Select the *Migration* view and click *Archetype*.
+. Click the *Options* menu ({kebab}) and select *Review* from the drop-down menu..
+. From the list of available questionnaires, click *Take* to select the desired assessment questionnaire.
+. In the *Assessment* menu, answer the required questions.
+. Select *Save and Review*. You will automatically be redirected to the *Review* tab.
+. Enter the following information:
+
+** *Proposed Action*: Proposed action required to complete the migration or modernization of the archetype. 
+** *Effort estimate*: The level of effort required to perform the modernization or migration of the selected archetype.
+** *Business criticality*: The level of criticality of the application to the business. 
+** *Work Priority*: The archetype’s priority.
+
+. Click *Submit review*. 

docs/web-console-guide/master.adoc

@@ -202,7 +202,9 @@ include::topics/proc_displaying-the-tags-of-an-application.adoc[leveloffset=+3]
 include::topics/mta-web-archetypes.adoc[leveloffset=+2]
 include::topics/proc_defining-an-archetype.adoc[leveloffset=+3]
 //include::topics/con_archetype-inheritance.adoc[leveloffset=+3]
-include::topics/con_archetype-assessment.adoc[leveloffset=+3]
+//include::topics/con_archetype-assessment.adoc[leveloffset=+3]
+include::topics/proc_assessing-an-archetype.adoc[leveloffset=+3]
+include::topics/proc_reviewing-an-archetype.adoc[leveloffset=+3]
 include::topics/proc_deleting-an-archetype.adoc[leveloffset=+3]
 // include::topics/mta-web-applying-assessments-to-other-apps.adoc[leveloffset=+3]