Skip to content

Conversation

@abrookins
Copy link
Collaborator

Summary

Reorganizes documentation and switches linting from black/isort/flake8 to ruff.

Documentation Changes

  • Split models.md into two focused pages:

    • models.md - Model definition, fields, validation, saving/loading, configuration
    • querying.md (new) - Comprehensive querying API documentation
  • Merged validation.md into models.md - Validation content now lives in the Models page

  • Updated migrations.md - Removed references to deprecated migrate command (only om migrate exists now)

  • Added make docs target - Start local docs server for preview

Linting Changes

  • Replaced black, isort, flake8 with ruff
  • Added ruff configuration to pyproject.toml
  • Minor formatting fixes from ruff

New querying.md covers:

  • All expression operators (==, !=, <, >, %, <<, >>, etc.)
  • String methods (startswith, endswith, contains)
  • Combining expressions with &, |, ~
  • Terminal methods (all(), first(), count(), page())
  • Sorting and stable pagination
  • Field projection (.values(), .only())
  • Bulk operations (.update(), .delete())
  • Vector search with KNNExpression
  • RedisVL integration
  • Raw Redis commands
  • Debugging and performance tips

@abrookins abrookins merged commit 0044f55 into main Jan 31, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants