ref(flags): add note about feature flag search (#13023)

* ref(flags): add note about searchable properties

* clarify searchable properties

* update wording

Author: michellewzhang

docs/concepts/search/searchable-properties/issues.mdx

@@ -180,7 +180,7 @@ Returns issues with a matching first time seen. Syntax is the same as `age`.
 
 ### `flags`
 
-For [feature flag evaluations](/product/issues/issue-details/feature-flags/#evaluation-tracking) set to `true` or `false`, the name of the feature flag.
+For [feature flag evaluations](/product/issues/issue-details/feature-flags/#evaluation-tracking) set to `true` or `false`, the name of the feature flag. For example, the syntax for searching for a flag with key `my_flag` and value `true` is `flags["my_flag"]:true`.
 
 - **Type:** boolean
 

docs/product/issues/issue-details/feature-flags/index.mdx

@@ -16,6 +16,8 @@ Enabling a feature flag integration provides deep insights into the state of you
 
 Flag evaluations will appear in the "Feature Flag" section of Issue Details page as a table, with "suspect" flag predictions highlighted in yellow. For each event, we track the 100 most recently evaluated flags leading up to the error. Learn more about how to interact with feature flag insights within the Sentry UI by reading the [Issue Details page documentation](/product/issues/issue-details/#feature-flags).
 
+Setting up evaluation tracking also allows you to use Issues Search in conjunction with feature flags. On Issues Search, using the `flags` keyword will allow you to filter for issues containing errors where the feature flag evaluated value is true or false. This allows you to quickly find all errors where a specific flag evaluation and its value of interest are present. See [searchable properties](/concepts/search/searchable-properties/issues/#flags) for more details about the search syntax.
+
 ### Set Up Evaluation Tracking
 
 To set up evaluation tracking, visit the SDK integration documentation for your platform:

docs/product/issues/issue-details/index.mdx

@@ -177,6 +177,8 @@ Enabling one or more of our [evaluation tracking integrations](/product/explore/
 
 ![Feature Flag Table](./img/ff-table.png)
 
+Setting up evaluation tracking also allows you to use Issues Search in conjunction with feature flags. On Issues Search, using the `flags` keyword will allow you to filter for issues containing errors where the feature flag evaluated value is true or false. This allows you to quickly find all errors where a specific flag evaluation and its value of interest are present. See [searchable properties](/concepts/search/searchable-properties/issues/#flags) for more details about the search syntax.
+
 Enabling a [change tracking integration](/product/explore/feature-flags/#change-tracking) will enable annotations on the event volume chart. These lines mark feature flag changes and can help identify regressions caused by a feature flag definition change.
 
 ![Feature Flag Release Chart](./img/ff-release.png)