openlayer 0.16.0 → 0.17.0

data/lib/openlayer/models/governance/rule_result_update_params.rb

@@ -37,18 +37,22 @@ module Openlayer
                  -> { Openlayer::Internal::Type::ArrayOf[Openlayer::Governance::RuleResultUpdateParams::Blocking] }
 
         # @!attribute deactivated
-        #   Whether this result is excluded from compliance calculations.
+        #   Whether this result is excluded from compliance calculations. Excludes just this
+        #   result, without deactivating the rule everywhere.
         #
         #   @return [Boolean, nil]
         optional :deactivated, Openlayer::Internal::Type::Boolean
 
         # @!attribute deactivated_reason
-        #   Why the result was excluded.
+        #   Why the result was excluded. Required when setting `deactivated` to `true`.
         #
         #   @return [String, nil]
         optional :deactivated_reason, String, api_name: :deactivatedReason, nil?: true
 
         # @!method initialize(rule_result_id:, assignee_id: nil, blocked_by: nil, blocking: nil, deactivated: nil, deactivated_reason: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Openlayer::Models::Governance::RuleResultUpdateParams} for more details.
+        #
         #   @param rule_result_id [String]
         #
         #   @param assignee_id [String, nil] The user responsible for this result.
@@ -57,9 +61,9 @@ module Openlayer
         #
         #   @param blocking [Array<Openlayer::Models::Governance::RuleResultUpdateParams::Blocking>] Rule results that this one blocks.
         #
-        #   @param deactivated [Boolean] Whether this result is excluded from compliance calculations.
+        #   @param deactivated [Boolean] Whether this result is excluded from compliance calculations. Excludes just this
         #
-        #   @param deactivated_reason [String, nil] Why the result was excluded.
+        #   @param deactivated_reason [String, nil] Why the result was excluded. Required when setting `deactivated` to `true`.
         #
         #   @param request_options [Openlayer::RequestOptions, Hash{Symbol=>Object}]
 
@@ -70,17 +74,23 @@ module Openlayer
           optional :id, String
 
           # @!attribute status
-          #   The compliance status of the rule for this entity.
+          #   The compliance status of the rule for this entity. Computed by Openlayer and
+          #   can't be set directly.
           #
           #   @return [Symbol, Openlayer::Models::Governance::RuleResultUpdateParams::BlockedBy::Status, nil]
           optional :status, enum: -> { Openlayer::Governance::RuleResultUpdateParams::BlockedBy::Status }
 
           # @!method initialize(id: nil, status: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Openlayer::Models::Governance::RuleResultUpdateParams::BlockedBy} for more
+          #   details.
+          #
           #   @param id [String]
           #
-          #   @param status [Symbol, Openlayer::Models::Governance::RuleResultUpdateParams::BlockedBy::Status] The compliance status of the rule for this entity.
+          #   @param status [Symbol, Openlayer::Models::Governance::RuleResultUpdateParams::BlockedBy::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
 
-          # The compliance status of the rule for this entity.
+          # The compliance status of the rule for this entity. Computed by Openlayer and
+          # can't be set directly.
           #
           # @see Openlayer::Models::Governance::RuleResultUpdateParams::BlockedBy#status
           module Status
@@ -106,17 +116,23 @@ module Openlayer
           optional :id, String
 
           # @!attribute status
-          #   The compliance status of the rule for this entity.
+          #   The compliance status of the rule for this entity. Computed by Openlayer and
+          #   can't be set directly.
           #
           #   @return [Symbol, Openlayer::Models::Governance::RuleResultUpdateParams::Blocking::Status, nil]
           optional :status, enum: -> { Openlayer::Governance::RuleResultUpdateParams::Blocking::Status }
 
           # @!method initialize(id: nil, status: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Openlayer::Models::Governance::RuleResultUpdateParams::Blocking} for more
+          #   details.
+          #
           #   @param id [String]
           #
-          #   @param status [Symbol, Openlayer::Models::Governance::RuleResultUpdateParams::Blocking::Status] The compliance status of the rule for this entity.
+          #   @param status [Symbol, Openlayer::Models::Governance::RuleResultUpdateParams::Blocking::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
 
-          # The compliance status of the rule for this entity.
+          # The compliance status of the rule for this entity. Computed by Openlayer and
+          # can't be set directly.
           #
           # @see Openlayer::Models::Governance::RuleResultUpdateParams::Blocking#status
           module Status

data/lib/openlayer/models/governance/rule_result_update_response.rb

@@ -6,13 +6,15 @@ module Openlayer
       # @see Openlayer::Resources::Governance::RuleResults#update
       class RuleResultUpdateResponse < Openlayer::Internal::Type::BaseModel
         # @!attribute deactivated
-        #   Whether this result is excluded from compliance calculations.
+        #   Whether this result is excluded from compliance calculations. Excludes just this
+        #   result, without deactivating the rule everywhere.
         #
         #   @return [Boolean]
         required :deactivated, Openlayer::Internal::Type::Boolean
 
         # @!attribute status
-        #   The compliance status of the rule for this entity.
+        #   The compliance status of the rule for this entity. Computed by Openlayer and
+        #   can't be set directly.
         #
         #   @return [Symbol, Openlayer::Models::Governance::RuleResultUpdateResponse::Status]
         required :status, enum: -> { Openlayer::Models::Governance::RuleResultUpdateResponse::Status }
@@ -39,7 +41,7 @@ module Openlayer
                  -> { Openlayer::Internal::Type::ArrayOf[Openlayer::Models::Governance::RuleResultUpdateResponse::Blocking] }
 
         # @!attribute deactivated_reason
-        #   Why the result was excluded.
+        #   Why the result was excluded. Required when setting `deactivated` to `true`.
         #
         #   @return [String, nil]
         optional :deactivated_reason, String, api_name: :deactivatedReason, nil?: true
@@ -113,17 +115,23 @@ module Openlayer
         end
 
         # @!method initialize(id:, date_created:, date_updated:, deactivated:, rule_id:, status:, workspace_id:, assignee_id: nil, blocked_by: nil, blocking: nil, date_last_evaluated: nil, date_of_latest_evidence: nil, date_of_next_evaluation: nil, date_of_renewal: nil, deactivated_reason: nil, project_id: nil, status_message: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Openlayer::Models::Governance::RuleResultUpdateResponse} for more details.
+        #
+        #   The compliance status of one rule for one entity: a project for project-scoped
+        #   rules, or the workspace for workspace-scoped rules.
+        #
         #   @param id [String] The rule result id.
         #
         #   @param date_created [Time] The creation date.
         #
         #   @param date_updated [Time] The last update date.
         #
-        #   @param deactivated [Boolean] Whether this result is excluded from compliance calculations.
+        #   @param deactivated [Boolean] Whether this result is excluded from compliance calculations. Excludes just this
         #
         #   @param rule_id [String] The rule this result belongs to.
         #
-        #   @param status [Symbol, Openlayer::Models::Governance::RuleResultUpdateResponse::Status] The compliance status of the rule for this entity.
+        #   @param status [Symbol, Openlayer::Models::Governance::RuleResultUpdateResponse::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
         #
         #   @param workspace_id [String] The id of the workspace the rule result belongs to.
         #
@@ -141,13 +149,14 @@ module Openlayer
         #
         #   @param date_of_renewal [Time, nil] When the evidence must be renewed. Evidence rules with a renewal cadence only.
         #
-        #   @param deactivated_reason [String, nil] Why the result was excluded.
+        #   @param deactivated_reason [String, nil] Why the result was excluded. Required when setting `deactivated` to `true`.
         #
         #   @param project_id [String, nil] The project this result was evaluated for. `null` for workspace-scoped rules.
         #
         #   @param status_message [String, nil] A human-readable explanation of the status.
 
-        # The compliance status of the rule for this entity.
+        # The compliance status of the rule for this entity. Computed by Openlayer and
+        # can't be set directly.
         #
         # @see Openlayer::Models::Governance::RuleResultUpdateResponse#status
         module Status
@@ -172,17 +181,23 @@ module Openlayer
           optional :id, String
 
           # @!attribute status
-          #   The compliance status of the rule for this entity.
+          #   The compliance status of the rule for this entity. Computed by Openlayer and
+          #   can't be set directly.
           #
           #   @return [Symbol, Openlayer::Models::Governance::RuleResultUpdateResponse::BlockedBy::Status, nil]
           optional :status, enum: -> { Openlayer::Models::Governance::RuleResultUpdateResponse::BlockedBy::Status }
 
           # @!method initialize(id: nil, status: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Openlayer::Models::Governance::RuleResultUpdateResponse::BlockedBy} for more
+          #   details.
+          #
           #   @param id [String]
           #
-          #   @param status [Symbol, Openlayer::Models::Governance::RuleResultUpdateResponse::BlockedBy::Status] The compliance status of the rule for this entity.
+          #   @param status [Symbol, Openlayer::Models::Governance::RuleResultUpdateResponse::BlockedBy::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
 
-          # The compliance status of the rule for this entity.
+          # The compliance status of the rule for this entity. Computed by Openlayer and
+          # can't be set directly.
           #
           # @see Openlayer::Models::Governance::RuleResultUpdateResponse::BlockedBy#status
           module Status
@@ -208,17 +223,23 @@ module Openlayer
           optional :id, String
 
           # @!attribute status
-          #   The compliance status of the rule for this entity.
+          #   The compliance status of the rule for this entity. Computed by Openlayer and
+          #   can't be set directly.
           #
           #   @return [Symbol, Openlayer::Models::Governance::RuleResultUpdateResponse::Blocking::Status, nil]
           optional :status, enum: -> { Openlayer::Models::Governance::RuleResultUpdateResponse::Blocking::Status }
 
           # @!method initialize(id: nil, status: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Openlayer::Models::Governance::RuleResultUpdateResponse::Blocking} for more
+          #   details.
+          #
           #   @param id [String]
           #
-          #   @param status [Symbol, Openlayer::Models::Governance::RuleResultUpdateResponse::Blocking::Status] The compliance status of the rule for this entity.
+          #   @param status [Symbol, Openlayer::Models::Governance::RuleResultUpdateResponse::Blocking::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
 
-          # The compliance status of the rule for this entity.
+          # The compliance status of the rule for this entity. Computed by Openlayer and
+          # can't be set directly.
           #
           # @see Openlayer::Models::Governance::RuleResultUpdateResponse::Blocking#status
           module Status

data/lib/openlayer/models/governance/rule_retrieve_response.rb

@@ -13,14 +13,16 @@ module Openlayer
 
         # @!attribute scope
         #   Whether the rule is evaluated once for the whole workspace, or once per project
-        #   the rule's frameworks apply to.
+        #   the rule's frameworks apply to. Must be `project` for platform rules. Fixed once
+        #   the rule is created.
         #
         #   @return [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Scope]
         required :scope, enum: -> { Openlayer::Models::Governance::RuleRetrieveResponse::Scope }
 
         # @!attribute type
         #   `platform` rules are evaluated automatically from the state of your Openlayer
-        #   workspace. `evidence` rules are satisfied by attaching evidence.
+        #   workspace. `evidence` rules are satisfied by attaching evidence. Fixed once the
+        #   rule is created.
         #
         #   @return [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Type]
         required :type, enum: -> { Openlayer::Models::Governance::RuleRetrieveResponse::Type }
@@ -32,7 +34,8 @@ module Openlayer
         optional :assignee_id, String, api_name: :assigneeId, nil?: true
 
         # @!attribute automation_params
-        #   Configuration for the platform check, when the automation takes parameters.
+        #   Configuration for the platform check, when the automation takes parameters. Omit
+        #   or `null` for evidence rules. Fixed once the rule is created.
         #
         #   @return [Hash{Symbol=>Object}, nil]
         optional :automation_params,
@@ -42,8 +45,9 @@ module Openlayer
 
         # @!attribute automation_type
         #   Which workspace signal a platform rule checks, for example
-        #   `monitoring_mode_enabled`, `test_setup`, or `project_owner_set`. `null` for
-        #   evidence rules.
+        #   `monitoring_mode_enabled`, `test_setup`, or `project_owner_set`. Set it for
+        #   platform rules; omit or `null` for evidence rules. Fixed once the rule is
+        #   created.
         #
         #   @return [String, nil]
         optional :automation_type, String, api_name: :automationType, nil?: true
@@ -61,7 +65,8 @@ module Openlayer
         optional :description, String, nil?: true
 
         # @!attribute evidence_type
-        #   The kind of evidence that satisfies the rule. `null` for platform rules.
+        #   The kind of evidence that satisfies the rule. Set it for evidence rules; omit or
+        #   `null` for platform rules. Fixed once the rule is created.
         #
         #   @return [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::EvidenceType, nil]
         optional :evidence_type,
@@ -71,7 +76,8 @@ module Openlayer
 
         # @!attribute renewal_cadence_days
         #   How often evidence must be renewed, in days. Once evidence is older than this,
-        #   the rule result becomes `due_soon` and then `failing`.
+        #   the rule result becomes `due_soon` and then `failing`. The window restarts
+        #   whenever evidence is attached. Omit or `null` for platform rules.
         #
         #   @return [Integer, nil]
         optional :renewal_cadence_days, Integer, api_name: :renewalCadenceDays, nil?: true
@@ -109,7 +115,8 @@ module Openlayer
                    -> { Openlayer::Internal::Type::ArrayOf[Openlayer::Models::Governance::RuleRetrieveResponse::Framework] }
 
           # @!attribute immutable
-          #   Whether the rule is managed by Openlayer and cannot be edited.
+          #   Whether the rule is managed by Openlayer. These rules can't be renamed or
+          #   deleted; set `deactivated` to exclude one from compliance instead.
           #
           #   @return [Boolean, nil]
           optional :immutable, Openlayer::Internal::Type::Boolean
@@ -145,6 +152,11 @@ module Openlayer
         #   Some parameter documentations has been truncated, see
         #   {Openlayer::Models::Governance::RuleRetrieveResponse} for more details.
         #
+        #   A single requirement Openlayer tracks. `platform` rules are evaluated
+        #   automatically from the state of your workspace, and `evidence` rules are
+        #   satisfied by attaching evidence. A rule can belong to several frameworks, or to
+        #   none.
+        #
         #   @param id [String] The rule id.
         #
         #   @param date_created [Time] The creation date.
@@ -161,7 +173,7 @@ module Openlayer
         #
         #   @param assignee_id [String, nil] The user responsible for satisfying the rule.
         #
-        #   @param automation_params [Hash{Symbol=>Object}, nil] Configuration for the platform check, when the automation takes parameters.
+        #   @param automation_params [Hash{Symbol=>Object}, nil] Configuration for the platform check, when the automation takes parameters. Omit
         #
         #   @param automation_type [String, nil] Which workspace signal a platform rule checks, for example `monitoring_mode_enab
         #
@@ -169,11 +181,11 @@ module Openlayer
         #
         #   @param description [String, nil] What the rule requires.
         #
-        #   @param evidence_type [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::EvidenceType, nil] The kind of evidence that satisfies the rule. `null` for platform rules.
+        #   @param evidence_type [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::EvidenceType, nil] The kind of evidence that satisfies the rule. Set it for evidence rules; omit or
         #
         #   @param frameworks [Array<Openlayer::Models::Governance::RuleRetrieveResponse::Framework>] The frameworks that include this rule.
         #
-        #   @param immutable [Boolean] Whether the rule is managed by Openlayer and cannot be edited.
+        #   @param immutable [Boolean] Whether the rule is managed by Openlayer. These rules can't be renamed or delete
         #
         #   @param renewal_cadence_days [Integer, nil] How often evidence must be renewed, in days. Once evidence is older than this, t
         #
@@ -184,7 +196,8 @@ module Openlayer
         #   @param tags [Array<Openlayer::Models::Governance::RuleRetrieveResponse::Tag>, nil] The rule tags associated with the rule.
 
         # Whether the rule is evaluated once for the whole workspace, or once per project
-        # the rule's frameworks apply to.
+        # the rule's frameworks apply to. Must be `project` for platform rules. Fixed once
+        # the rule is created.
         #
         # @see Openlayer::Models::Governance::RuleRetrieveResponse#scope
         module Scope
@@ -198,7 +211,8 @@ module Openlayer
         end
 
         # `platform` rules are evaluated automatically from the state of your Openlayer
-        # workspace. `evidence` rules are satisfied by attaching evidence.
+        # workspace. `evidence` rules are satisfied by attaching evidence. Fixed once the
+        # rule is created.
         #
         # @see Openlayer::Models::Governance::RuleRetrieveResponse#type
         module Type
@@ -211,7 +225,8 @@ module Openlayer
           #   @return [Array<Symbol>]
         end
 
-        # The kind of evidence that satisfies the rule. `null` for platform rules.
+        # The kind of evidence that satisfies the rule. Set it for evidence rules; omit or
+        # `null` for platform rules. Fixed once the rule is created.
         #
         # @see Openlayer::Models::Governance::RuleRetrieveResponse#evidence_type
         module EvidenceType
@@ -314,13 +329,15 @@ module Openlayer
 
         class Result < Openlayer::Internal::Type::BaseModel
           # @!attribute deactivated
-          #   Whether this result is excluded from compliance calculations.
+          #   Whether this result is excluded from compliance calculations. Excludes just this
+          #   result, without deactivating the rule everywhere.
           #
           #   @return [Boolean]
           required :deactivated, Openlayer::Internal::Type::Boolean
 
           # @!attribute status
-          #   The compliance status of the rule for this entity.
+          #   The compliance status of the rule for this entity. Computed by Openlayer and
+          #   can't be set directly.
           #
           #   @return [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Result::Status]
           required :status, enum: -> { Openlayer::Models::Governance::RuleRetrieveResponse::Result::Status }
@@ -347,7 +364,7 @@ module Openlayer
                    -> { Openlayer::Internal::Type::ArrayOf[Openlayer::Models::Governance::RuleRetrieveResponse::Result::Blocking] }
 
           # @!attribute deactivated_reason
-          #   Why the result was excluded.
+          #   Why the result was excluded. Required when setting `deactivated` to `true`.
           #
           #   @return [String, nil]
           optional :deactivated_reason, String, api_name: :deactivatedReason, nil?: true
@@ -421,17 +438,23 @@ module Openlayer
           end
 
           # @!method initialize(id:, date_created:, date_updated:, deactivated:, rule_id:, status:, workspace_id:, assignee_id: nil, blocked_by: nil, blocking: nil, date_last_evaluated: nil, date_of_latest_evidence: nil, date_of_next_evaluation: nil, date_of_renewal: nil, deactivated_reason: nil, project_id: nil, status_message: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Openlayer::Models::Governance::RuleRetrieveResponse::Result} for more details.
+          #
+          #   The compliance status of one rule for one entity: a project for project-scoped
+          #   rules, or the workspace for workspace-scoped rules.
+          #
           #   @param id [String] The rule result id.
           #
           #   @param date_created [Time] The creation date.
           #
           #   @param date_updated [Time] The last update date.
           #
-          #   @param deactivated [Boolean] Whether this result is excluded from compliance calculations.
+          #   @param deactivated [Boolean] Whether this result is excluded from compliance calculations. Excludes just this
           #
           #   @param rule_id [String] The rule this result belongs to.
           #
-          #   @param status [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Result::Status] The compliance status of the rule for this entity.
+          #   @param status [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Result::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
           #
           #   @param workspace_id [String] The id of the workspace the rule result belongs to.
           #
@@ -449,13 +472,14 @@ module Openlayer
           #
           #   @param date_of_renewal [Time, nil] When the evidence must be renewed. Evidence rules with a renewal cadence only.
           #
-          #   @param deactivated_reason [String, nil] Why the result was excluded.
+          #   @param deactivated_reason [String, nil] Why the result was excluded. Required when setting `deactivated` to `true`.
           #
           #   @param project_id [String, nil] The project this result was evaluated for. `null` for workspace-scoped rules.
           #
           #   @param status_message [String, nil] A human-readable explanation of the status.
 
-          # The compliance status of the rule for this entity.
+          # The compliance status of the rule for this entity. Computed by Openlayer and
+          # can't be set directly.
           #
           # @see Openlayer::Models::Governance::RuleRetrieveResponse::Result#status
           module Status
@@ -480,18 +504,24 @@ module Openlayer
             optional :id, String
 
             # @!attribute status
-            #   The compliance status of the rule for this entity.
+            #   The compliance status of the rule for this entity. Computed by Openlayer and
+            #   can't be set directly.
             #
             #   @return [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Result::BlockedBy::Status, nil]
             optional :status,
                      enum: -> { Openlayer::Models::Governance::RuleRetrieveResponse::Result::BlockedBy::Status }
 
             # @!method initialize(id: nil, status: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Openlayer::Models::Governance::RuleRetrieveResponse::Result::BlockedBy} for
+            #   more details.
+            #
             #   @param id [String]
             #
-            #   @param status [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Result::BlockedBy::Status] The compliance status of the rule for this entity.
+            #   @param status [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Result::BlockedBy::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
 
-            # The compliance status of the rule for this entity.
+            # The compliance status of the rule for this entity. Computed by Openlayer and
+            # can't be set directly.
             #
             # @see Openlayer::Models::Governance::RuleRetrieveResponse::Result::BlockedBy#status
             module Status
@@ -517,18 +547,24 @@ module Openlayer
             optional :id, String
 
             # @!attribute status
-            #   The compliance status of the rule for this entity.
+            #   The compliance status of the rule for this entity. Computed by Openlayer and
+            #   can't be set directly.
             #
             #   @return [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Result::Blocking::Status, nil]
             optional :status,
                      enum: -> { Openlayer::Models::Governance::RuleRetrieveResponse::Result::Blocking::Status }
 
             # @!method initialize(id: nil, status: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Openlayer::Models::Governance::RuleRetrieveResponse::Result::Blocking} for more
+            #   details.
+            #
             #   @param id [String]
             #
-            #   @param status [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Result::Blocking::Status] The compliance status of the rule for this entity.
+            #   @param status [Symbol, Openlayer::Models::Governance::RuleRetrieveResponse::Result::Blocking::Status] The compliance status of the rule for this entity. Computed by Openlayer and can
 
-            # The compliance status of the rule for this entity.
+            # The compliance status of the rule for this entity. Computed by Openlayer and
+            # can't be set directly.
             #
             # @see Openlayer::Models::Governance::RuleRetrieveResponse::Result::Blocking#status
             module Status
@@ -607,7 +643,7 @@ module Openlayer
             required :date_updated, Time, api_name: :dateUpdated
 
             # @!attribute immutable
-            #   Whether the tag is managed by Openlayer and cannot be edited or deleted.
+            #   Whether the tag is managed by Openlayer. These tags can't be deleted.
             #
             #   @return [Boolean]
             required :immutable, Openlayer::Internal::Type::Boolean
@@ -620,6 +656,9 @@ module Openlayer
           end
 
           # @!method initialize(id:, creator_id:, date_created:, date_updated:, immutable:, name:, workspace_id:, color: nil)
+          #   A label that groups rules across frameworks, for example by team or control
+          #   family.
+          #
           #   @param id [String] The rule tag id.
           #
           #   @param creator_id [String, nil] The user who created the tag. `null` for tags that ship with Openlayer.
@@ -628,7 +667,7 @@ module Openlayer
           #
           #   @param date_updated [Time] The last update date.
           #
-          #   @param immutable [Boolean] Whether the tag is managed by Openlayer and cannot be edited or deleted.
+          #   @param immutable [Boolean] Whether the tag is managed by Openlayer. These tags can't be deleted.
           #
           #   @param name [String] The tag name.
           #

data/lib/openlayer/models/governance/rule_stat_retrieve_response.rb

@@ -24,6 +24,10 @@ module Openlayer
         #   Some parameter documentations has been truncated, see
         #   {Openlayer::Models::Governance::RuleStatRetrieveResponse} for more details.
         #
+        #   Counts of rules and their results by status. Narrowed by the request's filters,
+        #   so `frameworkId` gives one framework's compliance and `projectId` gives one
+        #   project's.
+        #
         #   @param rule_results [Openlayer::Models::Governance::RuleStatRetrieveResponse::RuleResults] Counts of rule results, after any filters in the request, with breakdowns by the
         #
         #   @param rules [Openlayer::Models::Governance::RuleStatRetrieveResponse::Rules] Counts of the rules themselves, after any filters in the request.

data/lib/openlayer/models/governance/rule_tag_list_response.rb

@@ -53,7 +53,7 @@ module Openlayer
             required :date_updated, Time, api_name: :dateUpdated
 
             # @!attribute immutable
-            #   Whether the tag is managed by Openlayer and cannot be edited or deleted.
+            #   Whether the tag is managed by Openlayer. These tags can't be deleted.
             #
             #   @return [Boolean]
             required :immutable, Openlayer::Internal::Type::Boolean
@@ -66,6 +66,9 @@ module Openlayer
           end
 
           # @!method initialize(id:, creator_id:, date_created:, date_updated:, immutable:, name:, workspace_id:, color: nil)
+          #   A label that groups rules across frameworks, for example by team or control
+          #   family.
+          #
           #   @param id [String] The rule tag id.
           #
           #   @param creator_id [String, nil] The user who created the tag. `null` for tags that ship with Openlayer.
@@ -74,7 +77,7 @@ module Openlayer
           #
           #   @param date_updated [Time] The last update date.
           #
-          #   @param immutable [Boolean] Whether the tag is managed by Openlayer and cannot be edited or deleted.
+          #   @param immutable [Boolean] Whether the tag is managed by Openlayer. These tags can't be deleted.
           #
           #   @param name [String] The tag name.
           #

data/lib/openlayer/models/governance/rule_update_params.rb

@@ -39,7 +39,8 @@ module Openlayer
 
         # @!attribute renewal_cadence_days
         #   How often evidence must be renewed, in days. Once evidence is older than this,
-        #   the rule result becomes `due_soon` and then `failing`.
+        #   the rule result becomes `due_soon` and then `failing`. The window restarts
+        #   whenever evidence is attached. Omit or `null` for platform rules.
         #
         #   @return [Integer, nil]
         optional :renewal_cadence_days, Integer, api_name: :renewalCadenceDays, nil?: true