Skip to content

fix convolutions docstrings#2883

Merged
Adel-Moumen merged 1 commit into
speechbrain:developfrom
gfdb:fix-convolution-docstrings
Apr 14, 2025
Merged

fix convolutions docstrings#2883
Adel-Moumen merged 1 commit into
speechbrain:developfrom
gfdb:fix-convolution-docstrings

Conversation

@gfdb
Copy link
Copy Markdown
Contributor

@gfdb gfdb commented Apr 10, 2025

What does this PR do?

Although I'm sure there are many doc string problems across the code base, I just happened to come across these ones while browsing the code. Many defaults are missing and some that are present are incorrect (different from the real default) in some cases, which can be very misleading when trying to debug. For example, residuals saying it defaults to None, but in reality it is True. This PR fixes these incorrect default values, adds ones that are missing, and improves the type hints overall. This is done by either adding a missing type hint or fixing it, such as the use of Optional[__] despite the user not being able to pass None for that parameter.

Fixes #<issue_number>

Before submitting
  • Did you read the contributor guideline?
  • Did you make sure your PR does only one thing, instead of bundling different changes together?
  • Did you make sure to update the documentation with your changes? (if necessary)
  • Did you write any new necessary tests? (not for typos and docs)
  • Did you verify new and existing tests pass locally with your changes?
  • Did you list all the breaking changes introduced by this pull request?
  • Does your code adhere to project-specific code style and conventions?

PR review

Reviewer checklist
  • Is this pull request ready for review? (if not, please submit in draft mode)
  • Check that all items from Before submitting are resolved
  • Make sure the title is self-explanatory and the description concisely explains the PR
  • Add labels and milestones (and optionally projects) to the PR so it can be classified
  • Confirm that the changes adhere to compatibility requirements (e.g., Python version, platform)
  • Review the self-review checklist to ensure the code is ready for review

Copy link
Copy Markdown
Collaborator

@Adel-Moumen Adel-Moumen left a comment

Choose a reason for hiding this comment

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

LGTM! Thanks for the improvements :)

@gfdb
Copy link
Copy Markdown
Contributor Author

gfdb commented Apr 10, 2025

@Adel-Moumen seems to be an issue with import order, gonna fix

@gfdb gfdb force-pushed the fix-convolution-docstrings branch from 9aedf01 to a71b8ad Compare April 10, 2025 19:33
@gfdb
Copy link
Copy Markdown
Contributor Author

gfdb commented Apr 11, 2025

@Adel-Moumen readthedocs test seems broken

@gfdb gfdb force-pushed the fix-convolution-docstrings branch from a71b8ad to 6caaa3a Compare April 13, 2025 21:49
@gfdb
Copy link
Copy Markdown
Contributor Author

gfdb commented Apr 13, 2025

@Adel-Moumen fixed it, merged .readthedocs.yaml in, despite it being exactly the same as the file on develop, it is registering as a change...

@Adel-Moumen Adel-Moumen merged commit 806a7ab into speechbrain:develop Apr 14, 2025
5 checks passed
@Adel-Moumen
Copy link
Copy Markdown
Collaborator

Thanks @gfdb :)

pplantinga pushed a commit to pplantinga/speechbrain that referenced this pull request Jun 2, 2025
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