Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Doctests] Fix all T5 doc tests #16646

Merged

Conversation

patrickvonplaten
Copy link
Contributor

What does this PR do?

Corrects T5 model docs and adds them to doc tests

Before submitting

  • This PR fixes a typo or improves the docs (you can dismiss the other checks if that's the case).
  • Did you read the contributor guideline,
    Pull Request section?
  • Was this discussed/approved via a Github issue or the forum? Please add a link
    to it if that's the case.
  • Did you make sure to update the documentation with your changes? Here are the
    documentation guidelines, and
    here are tips on formatting docstrings.
  • Did you write any new necessary tests?

Who can review?

Anyone in the community is free to review the PR once the tests have passed. Feel free to tag
members/contributors who may be interested in your PR.

@HuggingFaceDocBuilderDev
Copy link

HuggingFaceDocBuilderDev commented Apr 7, 2022

The documentation is not available anymore as the PR was closed or merged.

Copy link
Collaborator

@sgugger sgugger left a comment

Choose a reason for hiding this comment

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

Thanks for fixing those. The examples are still a bit arcane with special values hard-coded in the middle, could you explain those a little bit better?

Comment on lines 56 to 61
>>> input_ids = (
... torch.tensor([list("Life is like a box of chocolates.".encode("utf-8"))]) + 3
>>> ) # add 3 for special tokens
>>> labels = (
... torch.tensor([list("La vie est comme une boîte de chocolat.".encode("utf-8"))]) + 3
>>> ) # add 3 for special tokens
Copy link
Collaborator

Choose a reason for hiding this comment

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

Can the comment go once above to avoid the formatting on several lines? And also maybe be more helpful because I have no idea what "add 3 for special tokens" means.

Comment on lines 104 to 108
>>> # Now Mask
>>> # Note that we can add "{extra_id_...}" to the string directly
>>> # as the Byte tokenizer would incorrectly merge the tokens
>>> # We need to work on the character level directly here
>>> # => mask to "The dog [258]a ball [257]park."
Copy link
Collaborator

Choose a reason for hiding this comment

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

We can or we can't? I don't understand this comment and why it results in using 258 and 257.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good point - Added more explanation!

docs/source/en/model_doc/t5.mdx Outdated Show resolved Hide resolved
@patrickvonplaten patrickvonplaten merged commit b24201f into huggingface:main Apr 13, 2022
@patrickvonplaten patrickvonplaten deleted the correct_t5_model_docs branch April 13, 2022 09:36
elusenji pushed a commit to elusenji/transformers that referenced this pull request Jun 12, 2022
* [Doctests] Fix all T5 doc tests

* make style

* Update docs/source/en/model_doc/t5.mdx

Co-authored-by: Sylvain Gugger <[email protected]>

* Apply Sylvains comments

* Apply suggestions from code review

Co-authored-by: Sylvain Gugger <[email protected]>
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.

3 participants