KEMBAR78
[Doctests] Fix all T5 doc tests by patrickvonplaten · Pull Request #16646 · huggingface/transformers · GitHub
Skip to content

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!

patrickvonplaten and others added 3 commits April 12, 2022 17:48
@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 <35901082+sgugger@users.noreply.github.com>

* Apply Sylvains comments

* Apply suggestions from code review

Co-authored-by: Sylvain Gugger <35901082+sgugger@users.noreply.github.com>
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