docs(search): ES-5590 Add GQL Search improved feature ES-5244 (#932)

<!-- Ticket number or summary of work -->
### [ES-5590](https://bigcommercecloud.atlassian.net/browse/ES-5590)


## What changed?
<!-- Provide a bulleted list in the present tense -->
- Reorganize and enhance documentation for faceted and textual search in
the GraphQL Storefront API
- Add comprehensive examples of AND/OR logic for category-based product
filtering
- Include detailed explanation of product attribute filtering with code
examples
- Add limitations and recommendations section with practical workarounds

## Release notes draft
We've revamped our GraphQL Storefront API search documentation to make
implementing faceted and textual search easier than ever. The enhanced
documentation provides clearer examples, explains filtering logic
options, and includes practical recommendations to help you build
powerful product search experiences for your headless storefront.
Whether you're displaying filtered category pages, implementing search
with facets, or creating complex filter combinations, this documentation
will guide you through the process.

## Anything else?
<!-- Add related PRs, salient notes, additional ticket numbers, etc. -->
[ES-5344](https://bigcommercecloud.atlassian.net/browse/ES-5244)
[PR](bigcommerce/interfaces#3301)
[Relevant discussion doc
](https://docs.google.com/document/d/15wZaRphbxa-N7wlwge5z_xomyiaJJLLBZk5_utEfk0U/edit?usp=sharing)

ping @bc-andreadao @knowakowski 


[ES-5590]:
https://bigcommercecloud.atlassian.net/browse/ES-5590?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
[ES-5344]:
https://bigcommercecloud.atlassian.net/browse/ES-5344?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ

Author: jfugalde