Merge pull request openshift#55487 from kcarmichael08/policy-categories-3.74

Update documentation to add policy category changes

Author: kelbrown20

modules/create-policy-categories-using-tab.adoc

@@ -0,0 +1,21 @@
+// Module included in the following assemblies:
+//
+// * operating/manage-security-policies.adoc
+:_content-type: PROCEDURE
+[id="create-policy-categories-using-tab_{context}"]
+= Creating policy categories using the Policy categories tab
+
+{product-title-short} version 3.74 provides a new method to create and manage policy categories in {product-title-managed} or in {product-title-short} if you have the PostgreSQL database (Technology Preview) enabled. All policy workflows other than policy creation remain unchanged when using this feature. 
+
+You can also configure policy categories by using the `PolicyCategoryService` API object. For more information, navigate to *Help* -> *API reference* in the {product-title-short} portal. 
+
+:FeatureName: PostgreSQL support
+include::snippets/technology-preview.adoc[]
+
+.Procedure
+
+. On the {product-title-short} portal, navigate to *Platform Configuration* -> *Policy Management*.
+. Click the *Policy categories* tab. This tab provides a list of existing categories and allows you to filter the list by category name. You can also click *Show all categories* and select the checkbox to remove default or custom categories from the displayed list.
+. Click *Create category*.
+. Enter a category name and click *Create*.
+

modules/create-policy-categories.adoc

@@ -1,18 +1,18 @@
 // Module included in the following assemblies:
 //
 // * operating/manage-security-policies.adoc
-:_module-type: PROCEDURE
+:_content-type: PROCEDURE
 [id="create-policy-categories_{context}"]
-= Creating policy categories
+= Creating policy categories during policy creation
 
 You can create new policy categories from the system policies view.
 
 .Procedure
-. On the RHACS portal, navigate to *Platform Configuration* -> *Policies*.
+
+. On the {product-title-short} portal, navigate to *Platform Configuration* -> *Policy Management*.
 . From the *Policies* page, select the policy you want to edit.
 . Select *Actions* -> *Edit policy*.
-. Enter a new category name in the *Categories* field and then click *Create <category>*.
+. In the *Policy details* section, enter a new category name in the *Categories* field and then click *Create <category>*. 
 . Click the *Review policy* section heading.
 . Click *Save*.
 
-After you save the configuration, the new category displays on the dashboard if there are any violations for policies in the category.

modules/modify-existing-security-policies.adoc

@@ -1,15 +1,15 @@
 // Module included in the following assemblies:
 //
 // * operating/manage-security-policies.adoc
-:_module-type: PROCEDURE
+:_content-type: PROCEDURE
 [id="modify-existing-security-policies_{context}"]
 = Modifying existing security policies
 
 [role="_abstract"]
 You can edit the policies you have created and the existing default policies provided by {product-title}.
 
 .Procedure
-. On the RHACS portal, navigate to *Platform Configuration* -> *Policies*.
+. On the {product-title-short} portal, navigate to *Platform Configuration* -> *Policies*.
 . From the *Policies* page, select the policy you want to edit.
 . Select *Actions* -> *Edit policy*.
 . Modify the *Policy details*. You can modify the policy name, severity, categories, description, rationale, and guidance.

modules/modify-policy-categories-using-tab.adoc

@@ -0,0 +1,19 @@
+// Module included in the following assemblies:
+//
+// * operating/manage-security-policies.adoc
+:_content-type: PROCEDURE
+[id="modify-policy-categories-using-tab_{context}"]
+= Modifying policy categories using the Policy categories tab
+
+{product-title-short} version 3.74 provides a new method to create and manage policy categories in {product-title-managed} or in {product-title-short} if you have the PostgreSQL database (Technology Preview) enabled. All policy workflows other than policy creation remain unchanged when using this feature. For instructions on using this feature, see the second procedure in the following section.
+
+You can also configure policy categories by using the `PolicyCategoryService` API object. For more information, navigate to *Help* -> *API reference* in the {product-title-short} portal. 
+
+:FeatureName: PostgreSQL support
+include::snippets/technology-preview.adoc[]
+
+.Procedure
+
+. On the {product-title-short} portal, navigate to *Platform Configuration* -> *Policy Management*.
+. Click the *Policy categories* tab. This tab provides a list of existing categories and allows you to filter the list by category name. You can also click *Show all categories* and select the checkbox to remove default or custom categories from the displayed list.
+. Click a policy name to edit or delete it. Default policy categories cannot be selected, edited, or deleted.

modules/snippets

@@ -0,0 +1 @@
+../snippets/

operating/manage-security-policies.adoc

@@ -17,7 +17,18 @@ include::modules/modify-existing-security-policies.adoc[leveloffset=+1]
 .Additional resources
 * xref:../operating/manage-security-policies.adoc#create-policy-from-system-policies-view_manage-security-policies[Creating a security policy from the system policies view]
 
-include::modules/create-policy-categories.adoc[leveloffset=+1]
+[id="create-policy-categories-all"]
+== Creating and managing policy categories
+
+You can create and manage policy categories by using the following methods:
+
+* Create a policy category in the *Policy details* section when you create a policy. The category names are stored as strings that are attached to the policy and cannot be copied or deleted.
+* Create, copy, or delete a policy category by navigating to *Platform Configuration* -> *Policy Management* and clicking the *Policy categories* tab. The policy categories are stored in the database and can be managed. This option is available only in {product-title-managed} or in {product-title-short} if you have the PostgreSQL database (Technology Preview) enabled.
+
+include::modules/create-policy-categories.adoc[leveloffset=+2]
+include::modules/create-policy-categories-using-tab.adoc[leveloffset=+2]
+include::modules/modify-policy-categories-using-tab.adoc[leveloffset=+2]
+
 [role="_additional-resources"]
 .Additional resources
 * xref:../operating/manage-security-policies.adoc#create-policy-from-system-policies-view_manage-security-policies[Creating a security policy from the system policies view]
@@ -29,7 +40,7 @@ In addition to using the default policies, you can also create custom policies i
 
 To build a new policy, you can clone an existing policy or create a new one from scratch.
 
-* You can also create policies based on the filter criteria in the *Risk* view in the RHACS portal.
+* You can also create policies based on the filter criteria in the *Risk* view in the {product-title-short} portal.
 * You can also use `AND`, `OR`, and `NOT` logical operators for policy criteria to create advanced policies.
 
 include::modules/create-policy-from-system-policies-view.adoc[leveloffset=+2]