Skip to content

docs: Update terminology from 'hybrid queries' to 'complex filtering'#472

Merged
tylerhutcherson merged 3 commits intomainfrom
update-hybrid-search-terminology
Feb 13, 2026
Merged

docs: Update terminology from 'hybrid queries' to 'complex filtering'#472
tylerhutcherson merged 3 commits intomainfrom
update-hybrid-search-terminology

Conversation

@jeremyplichta
Copy link
Contributor

Summary

This PR updates the documentation terminology to distinguish between:

  • Complex filtering: Combining multiple filter types (tag, numeric, geo, text filters) - previously called 'hybrid queries'
  • Hybrid search: The new FT.HYBRID command that combines text and vector search (HybridQuery/AggregateHybridQuery classes)

Changes

  • Renamed docs/user_guide/02_hybrid_queries.ipynb to docs/user_guide/02_complex_filtering.ipynb
  • Updated README.md to use 'complex filtering' terminology instead of 'hybrid queries'
  • Updated docs/user_guide/index.md table of contents
  • Updated notebook content to reflect the new terminology

Notes

  • The HybridQuery and AggregateHybridQuery classes remain unchanged as they correctly refer to the FT.HYBRID command which combines text and vector search
  • The 11_advanced_queries.ipynb notebook correctly documents hybrid search using the FT.HYBRID command
  • This change improves clarity by reserving 'hybrid search' for the specific FT.HYBRID functionality introduced in Redis 8.4.0

Testing

  • Documentation changes only, no code changes
  • Verified all file references are updated consistently

Pull Request opened by Augment Code with guidance from the PR author

- Renamed 02_hybrid_queries.ipynb to 02_complex_filtering.ipynb
- Updated README.md to use 'complex filtering' terminology
- Updated docs/user_guide/index.md table of contents
- Updated notebook content to reflect new terminology
- Note: HybridQuery and AggregateHybridQuery classes remain unchanged
  as they refer to the FT.HYBRID command which combines text and vector search
Copilot AI review requested due to automatic review settings February 11, 2026 17:45
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates documentation terminology to clearly distinguish between "complex filtering" (combining multiple filter types like tag, numeric, geo, and text) and "hybrid search" (the FT.HYBRID command that combines text and vector search). This improves clarity by reserving "hybrid search" for the specific Redis functionality introduced in Redis 8.4.0.

Changes:

  • Renamed documentation file from 02_hybrid_queries.ipynb to 02_complex_filtering.ipynb to reflect the new terminology
  • Updated all documentation references from "hybrid queries" to "complex filtering" across README.md, user guide index, and notebook content
  • Preserved the correct naming of HybridQuery/AggregateHybridQuery classes which properly refer to the FT.HYBRID command

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
docs/user_guide/index.md Updated table of contents to reference 02_complex_filtering instead of 02_hybrid_queries
docs/user_guide/02_complex_filtering.ipynb Updated notebook heading and description from "Hybrid Queries" to "Complex Filtering" with clearer explanation
README.md Updated feature table, workload descriptions, and documentation links to use "complex filtering" terminology

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@tylerhutcherson
Copy link
Collaborator

@claude Can you also make sure the README has Hybrid Search and Complex Filtering separated in the list of links?

@claude
Copy link
Contributor

claude bot commented Feb 13, 2026

Claude finished @tylerhutcherson's task —— View job


I'll help ensure the README properly separates Hybrid Search and Complex Filtering in the links section.

Todo List

  • Read current README.md to understand the structure
  • Identify the links section that needs separation
  • Update README to properly separate Hybrid Search and Complex Filtering links
  • Commit changes (push failed due to permissions)

Changes Made

I successfully updated the README to properly separate Hybrid Search and Complex Filtering:

  1. Added "Hybrid Search" as a separate capability in the capabilities table (line 35):

    • Hybrid Search: Combine text and vector search
    • Complex Filtering: Combine multiple filter types (already existed)
  2. Added hybrid search documentation link (line 221):

This properly distinguishes between:

  • Complex Filtering: Combining multiple filter types (tag, numeric, geo, text filters) - documented in 02_complex_filtering.ipynb
  • Hybrid Search: The FT.HYBRID command that combines text and vector search (HybridQuery/AggregateHybridQuery classes) - documented in 11_advanced_queries.ipynb

Note: The commit was created locally but the push failed due to GitHub Actions permissions. You'll need to manually push the changes or grant the appropriate permissions.

@tylerhutcherson tylerhutcherson self-requested a review February 13, 2026 08:08
@tylerhutcherson tylerhutcherson added the documentation Improvements or additions to documentation label Feb 13, 2026
Copilot AI review requested due to automatic review settings February 13, 2026 08:41
Copy link
Collaborator

@tylerhutcherson tylerhutcherson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@tylerhutcherson tylerhutcherson merged commit fc18904 into main Feb 13, 2026
18 checks passed
@tylerhutcherson tylerhutcherson deleted the update-hybrid-search-terminology branch February 13, 2026 08:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

Comments