GITBOOK-8894: vc-GitHub custom properties at Group level

Author: aluca3

docs/manage-assets/assets-inventory-components.md

@@ -144,8 +144,9 @@ Click a Controls logo to see **Last test** details and the **Issues** count, spl
 
 Asset tags are metadata labels applied to repository assets and build artifacts. You can use asset tags to tag based on predefined values, manage and apply security policies, and group assets based on common characteristics. The following asset types are available:
 
+* **GitHub custom properties** - lists the GitHub custom properties associated with your GitHub repository as a tag.
+* **User-defined tags** are customizable, as you can define their logic through Assets Policies. For example, you can set tags to label a repository that comes from a specific source, such as GitHub. Tags associated with assets are identified in the UI with the **Asset policy tags** name.
 * **System tags** are automatically assigned by Snyk based on asset names or detected keywords (for example, `codeowners`).
-* **User-defined tags** are customizable, as you can define their logic through Assets Policies. For example, you can set tags to label a repository that comes from a specific source, such as GitHub.
 
 A repository asset tag can be added through Policies or be system-generated by Snyk Essentials to provide more context. Click on a tags field to view all tags.
 
@@ -170,6 +171,12 @@ A system-generated tag includes the following information:
 
 ### Tag rules overview
 
+Tags are organized into three main categories:
+
+* GitHub custom properties
+* Asset policy tags
+* System tags
+
 System tags are automatically generated from the SCM repositories. System tags can be classified into three main categories:
 
 * Languages:

docs/manage-assets/assets-inventory-features.md

@@ -76,9 +76,6 @@ You can filter the information for all the inventory layouts and can use the fol
   * **Inactive**: The last commits were made in the last 3 - 6 months.
   * **Dormant**: No commits in the last 6 months.
   * **N/A**: There are no commits detected by Snyk Essentials.
-* **Source** - specify the asset source.
-* **Tags** - information about the detected languages and repository update status.
-* **Title\*** - represents the name of the component for which the application context catalog was configured.
 
 {% hint style="info" %}
 N/A indicates that the repository was detected through a Snyk scan but not directly from the SCM. To detect SCM repositories, you must set up SCM integration at the Group level.

docs/manage-risk/policies/assets-policies/README.md

@@ -46,8 +46,9 @@ Classify repository assets according to their business criticality from A (most
 
 Categorize and label repository assets with [asset tags](../../../manage-assets/assets-inventory-components.md#asset-tags) to filter the asset inventory. 
 
-* **System tags** - are automatically assigned by Snyk according to recognized keywords. 
-* **User-defined tags** - are customizable, as you can define the logic governing them through [Assets Policies](./). 
+* **GitHub custom properties** - lists the GitHub custom properties associated with your GitHub repository as a tag
+* **User-defined tags** are customizable, as you can define their logic through [Assets Policies](./). For example, you can set tags to label a repository that comes from a specific source, such as GitHub. Tags associated with assets are identified in the UI with the **Asset policy tags** name.
+* **System tags** are automatically assigned by Snyk based on asset names or detected keywords (for example, `codeowners`).
 
 ### Security coverage
 

docs/manage-risk/policies/assets-policies/create-policies.md

@@ -65,6 +65,7 @@ Each property contains different options for conditions and values:
 | Catalog name\*               | <ul><li>Is one of</li><li>Is not one of</li></ul>                                                                                         | the list of names of your application context.                                                                        |
 | Category                     | <ul><li>Is one of</li><li>Is not one of</li></ul>                                                                                         | the list of the available categories of a repository asset                                                            |
 | Class                        | <ul><li>Is one of</li><li>Is not one of</li></ul>                                                                                         | A, B, C, D                                                                                                            |
+| Clusters                     | <ul><li>containing one or more of</li><li>containing all of</li><li>not containing one or more of</li><li>not containing all of</li></ul> | the list of the available clusters                                                                                    |
 | Coverage                     | <ul><li>containing one or more of</li><li>containing all of</li><li>not containing one or more of</li><li>not containing all of</li></ul> | Snyk Code, Container, IaC, Open Source                                                                                |
 | Coverage gap                 | <ul><li>containing one or more of</li><li>containing all of</li><li>not containing one or more of</li><li>not containing all of</li></ul> | Snyk Code, Container, IaC, Open Source                                                                                |
 | Developers                   | <ul><li>is</li><li>is not</li><li>contains</li><li>does not contain</li><li>starts with</li><li>ends with</li></ul>                       | \[string]                                                                                                             |
@@ -75,6 +76,7 @@ Each property contains different options for conditions and values:
 | Lifecycle\*                  | <ul><li>Is one of</li><li>Is not one of</li></ul>                                                                                         | the available list of the lifecycle states of the application context component                                       |
 | Locked attributes            | <ul><li>is one of</li><li>is not one of</li></ul>                                                                                         | <ul><li>Class</li></ul>                                                                                               |
 | Owner\*                      | <ul><li>is one of</li><li>is not one of</li></ul>                                                                                         | the list of teams owning the repository for which the application context was configured.                             |
+| Related package              | <ul><li>is</li><li>is not</li><li>contains</li><li>does not contain</li><li>starts with</li><li>ends with</li></ul>                       | \[string]                                                                                                             |
 | Risk factors                 | <ul><li>containing one or more of</li><li>containing all of</li><li>not containing one or more of</li><li>not containing all of</li></ul> | the list of available risk factors                                                                                    |
 | Runtime discovered           | <ul><li>Is within</li><li>Is not within</li></ul>                                                                                         | <ul><li>Last 24 hours</li><li>Last 7 days</li><li>Last 30 days</li><li>Last 12 months</li><li>Year to date</li></ul>  |
 | Runtime last seen            | <ul><li>Is within</li><li>Is not within</li></ul>                                                                                         | <ul><li>Last 24 hours</li><li>Last 7 days</li><li>Last 30 days</li><li>Last 12 months</li><li>Year to date</li></ul>  |

docs/manage-risk/policies/assets-policies/implement-policies.md

@@ -13,7 +13,7 @@ Access the main view of the Policy function to see a list of all your policies a
 You can hover over a policy to gain access to extra details:
 
 * **Go to flow** - Opens the policy.
-* **Details** - Provides details on policy creation and modifications, including dates and creators.
+* **Edit name and description** - Allows you to edit the name and description of the policy.
 * **Clone** - Duplicates the policy.
 * **Delete** - Removes the policy.