docs: suggestions/changes

Author: roerohan

src/content/docs/flagship/index.mdx

@@ -18,7 +18,7 @@ import {
 
 <Description>
 
-Evaluate feature flags at the edge in Cloudflare Workers.
+Ship features safely with feature flags.
 
 </Description>
 

src/content/docs/flagship/reference/limits.mdx

@@ -13,7 +13,7 @@ Flagship enforces the following limits.
 | ------------------------------- | -------- |
 | Apps per account                | 10,000   |
 | Flags per app                   | 5,000    |
-
+| Condition nesting depth         | 6 levels |
 | Flag configuration size per app | 25 MB    |
 
 :::note
@@ -22,4 +22,5 @@ The apps-per-account and flags-per-app limits are soft limits. If your use case
 
 ## Notes
 
+- Condition nesting depth counts from the top-level condition group. A flat list of conditions (no nesting) has a depth of 1.
 - Flag configuration size refers to the total serialized size of all flags within a single app, including their variations and rules.

src/content/docs/flagship/targeting/index.mdx

@@ -31,32 +31,15 @@ Each condition compares an attribute from the evaluation context against a value
 
 ## Logical grouping
 
-Conditions within a rule are combined with `AND` and `OR` operators. The grouping follows a simple rule: **`OR` starts a new group, `AND` stays in the current group**. Equivalently, `AND` binds tighter than `OR`.
+Conditions within a rule can be grouped with `AND`/`OR` operators and nested up to six levels deep.
 
-You can think of the condition list as being split at every `OR` boundary. Each segment between `OR`s forms its own group, and all `AND`s inside that segment belong to the same group. The rule matches when any one group matches entirely.
+For example, to target enterprise users in the US or Canada:
 
-For example:
-
-```
-IF   country IN ["US", "CA"]
-AND  plan equals "enterprise"
-OR   email ends_with "cloudflare.com"
-OR   beta_tester equals true
-AND  user_age_days > 30
-```
-
-This evaluates as:
-
-```
-(country IN ["US", "CA"] AND plan equals "enterprise")
-OR (email ends_with "cloudflare.com")
-OR (beta_tester equals true AND user_age_days > 30)
-```
-
-The rule matches users who are either:
-- in the US or Canada **and** on the enterprise plan, or
-- using a `cloudflare.com` email address, or
-- a beta tester **and** have been a user for more than 30 days.
+- `AND`:
+  - `plan equals "enterprise"`
+  - `OR`:
+    - `country equals "US"`
+    - `country equals "CA"`
 
 ## Learn more