Skip to content

add missing docstrings to util and cli/_util functions#13987

Open
RavSinghChandan wants to merge 1 commit into
explosion:masterfrom
RavSinghChandan:docs/add-missing-docstrings-util
Open

add missing docstrings to util and cli/_util functions#13987
RavSinghChandan wants to merge 1 commit into
explosion:masterfrom
RavSinghChandan:docs/add-missing-docstrings-util

Conversation

@RavSinghChandan

Copy link
Copy Markdown

Several public functions in spacy/util.py and spacy/cli/_util.py were missing docstrings while the surrounding functions had them.

Added docstrings following the existing spaCy style (param (type): desc / RETURNS (type): desc) to:

  • is_unconstrained_version — was the only function in the version-checking block without one
  • create_default_optimizer — one-liner with no explanation of what it returns
  • check_lexeme_norms — no description of its args or side effects
  • raise_error / ignore_error — error handler callbacks used as arguments elsewhere but undocumented
  • setup_cli — entry point function with no docstring

No logic changed.

is_unconstrained_version, create_default_optimizer, check_lexeme_norms,
raise_error, ignore_error in util.py and setup_cli in cli/_util.py
were all missing docstrings
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.

1 participant