Skip to content

Conversation

@devicemxl
Copy link

What does this PR do?

docstrings enhancing

Related Issues

Fixes # docstrings enhancing

Updated docstrings for clarity and added details about the embedding computation process.
Added docstrings to SearchResult and PassageManager classes, detailing their attributes and methods.
Updated docstring to clarify candidate path resolution priority and added comments for better understanding.
Added detailed docstrings for the LeannBuilder class and its methods, explaining their purpose and parameters.
Added detailed docstrings to the LeannSearcher class methods for better understanding and usage. Improved logging docstrings.
Added docstrings to methods for better clarity and understanding of their functionality.
@andylizf
Copy link
Collaborator

Thanks for adding docstrings! However, there are a few issues that need to be fixed before we can merge:

1. Syntax Error: Double docstring

def get_registered_backends() -> list[str]:
    """Get list of registered backend names."""
    """
    Retrieves the installed and registered search backends.
    ...
    """

Two consecutive docstrings is a syntax error - the second one becomes a dead string literal. Please remove the duplicate or merge them into one.

2. Spanish comments mixed in

Please use English consistently throughout. Found Spanish comments like:

  • # Preparación de datos para el motor de filtrado
  • # Re-encapsulamiento en objetos SearchResult
  • # ... [Lógica de validación y limpieza]

3. Inconsistent comment style

Some inline comments are in English, some in Spanish. Please unify to English.


Once these are fixed, we'd be happy to merge. Thanks for your contribution!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants