Merge pull request #64 from checkly/paula/tree-202-entitlements-group-troubleshoot

feat: entitlements group troubleshoot [tree-202]

Author: Dgiordano33

constructs/check-group-v2.mdx

@@ -265,6 +265,15 @@ When referencing existing groups with `fromId()`, note:
 
 If you need these features, you can either import the group using the [Checkly import feature](/cli/checkly-import) (e.g. `npx checkly import check-group:123`) or define a new group directly in your project.
 
+## Shared Settings in Groups with Different Monitor Types
+
+With `CheckGroupV2` you can group uptime monitors (e.g. URL, TCP, DNS) and synthetic checks (e.g. API, Multistep, Playwright Check Suites). Depending on your plan type, some [group settings](/constructs/check-group-v2#configuration) (such as parallel runs or advanced retry strategies) may not be supported across both monitor types.
+
+To avoid conflicts, Checkly validates group settings against the lowest common denominator of supported features in the group.
+
+See [Mixing Checks and Monitors in a Group](/platform/groups/#mixing-checks-and-monitors-in-a-group) for details.
+
+
 ## Examples
 
 <Tabs>

platform/groups.mdx

@@ -146,3 +146,17 @@ Groups can serve different organizational needs:
 - **Loose containers:** Provide structure without imposing shared settings
 - **Team boundaries:** Enable clear ownership and delegation of monitoring responsibilities
 - **Scaling mechanism:** Manage complexity through logical decomposition as your infrastructure grows
+
+
+## Mixing Checks and Monitors in a Group
+
+When you purchase a plan in Checkly, it includes access to specific monitoring features. As shown on our [pricing page](https://www.checklyhq.com/pricing), feature availability can differ between:
+
+* Uptime monitors (e.g. URL, TCP, DNS)
+* Synthetic checks (e.g. API, Multistep, Browser, Playwright Check Suites)
+
+This means monitors and checks on the same plan may not all have access to the same features. For example: A Browser check might support `parallel` scheduling, while a TCP monitor only allows for `round-robin` scheduling.
+
+Groups let you organize any type of checks/monitors together and define [shared settings](/platform/groups#configuration). If those shared settings aren't supported by all monitors in the group, Checkly will throw a validation error asking you to either adjust the configuration or remove the incompatible monitor.
+
+If you're unsure how to proceed, don't hesitate to reach out to our [support team](mailto:[email protected]), we're happy to help.