Skip to content

Conversation

@mattip
Copy link
Contributor

@mattip mattip commented Jul 13, 2020

Merge after gh-41334 and gh-41321 (EDIT: both are merged).
Closes gh-38011

This is the last in a series of PRs to build documentation without warnings. It adds -WT --keepgoing to the shpinx build which will fail the build if there are warnings, print a trackeback on error and finish the build even when there are warnings.

It should fail now, but pass once the PRs mentioned at the top are merged.

@mattip mattip changed the title Doc warnings4 DOC: fail to build if there are warnings Jul 13, 2020
@mattip
Copy link
Contributor Author

mattip commented Jul 13, 2020

xref gh-32703: should this also close that issue?

@dr-ci
Copy link

dr-ci bot commented Jul 13, 2020

💊 CI failures summary and remediations

As of commit 622feb6 (more details on the Dr. CI page):


💚 💚 Looks good so far! There are no failures yet. 💚 💚


This comment was automatically generated by Dr. CI (expand for details).Follow this link to opt-out of these comments for your Pull Requests.

Please report bugs/suggestions on the GitHub issue tracker or post in the (internal) Dr. CI Users group.

See how this bot performed.

This comment has been revised 20 times.

@ailzhang ailzhang requested a review from jlin27 July 13, 2020 15:52
@ailzhang ailzhang added the triaged This issue has been looked at a team member, and triaged and prioritized into an appropriate module label Jul 13, 2020
@rgommers
Copy link
Collaborator

Prerequisites are merged, so let's see if this is still passing.

@rgommers
Copy link
Collaborator

@pytorchbot rebase this please

@rgommers
Copy link
Collaborator

Hmm the bot seems to be asleep. Also, the pytorch_doc_test job shows some warnings that cause a CI failure. @mattip can you address those and rebase?

Copy link
Contributor Author

@mattip mattip left a comment

Choose a reason for hiding this comment

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

Most of these changes were needed since more changes to documentation after PRs gh-41334 and gh-41321 were made.


# You can set these variables from the command line.
SPHINXOPTS ?= -j auto
SPHINXOPTS ?= -j auto -WT --keep-going
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is the actual one-liner meant to be in the PR

wait
ScriptModule
ScriptFunction
freeze
Copy link
Contributor Author

Choose a reason for hiding this comment

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

freeze -> _freeze, it is now a private module

def set_default_dtype(d):
r"""Sets the default floating point dtype to :attr:`d`.
This dtype is:
Copy link
Contributor Author

Choose a reason for hiding this comment

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

blank line needed

d (:class:`torch.dtype`): the floating point dtype to make the default
Example::
Example:
Copy link
Contributor Author

Choose a reason for hiding this comment

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

not really an error, just a cleanup

Example::
Example:
Copy link
Contributor Author

Choose a reason for hiding this comment

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

blank line preferred

tensor([[[-0.8079],
[ 0.7460]],
<BLANKLINE>
Copy link
Contributor Author

Choose a reason for hiding this comment

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

doctests need this to pass

Copy link
Collaborator

Choose a reason for hiding this comment

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

There are zero other instances of BLANKLINE, so I guess that makes this the only 3-D array in an example. Hence not worth cleaning this up with better doctest machinery I think.

A bit odd though that doctest failures don't turn into actual failures, that should be separate from -WT right?

"""Saves an object to a disk file.
See also: :ref:`recommend-saving-models`
See also: `saving-loading-tensors`
Copy link
Contributor Author

Choose a reason for hiding this comment

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

The file docs/source/notes/serialization.rst was refactored

Copy link
Contributor Author

@mattip mattip left a comment

Choose a reason for hiding this comment

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

Fixed the docs build script too.


# Install TensorBoard in python 3 so torch.utils.tensorboard classes render
pip install -q https://s3.amazonaws.com/ossci-linux/wheels/tensorboard-1.14.0a0-py3-none-any.whl

Copy link
Contributor Author

Choose a reason for hiding this comment

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

this is now handled via requirements.txt on line 62

@rgommers
Copy link
Collaborator

LGTM now, doc build all green. @jlin27 or @mruberry can one of you land this?

@mruberry mruberry self-requested a review July 28, 2020 16:49
Copy link
Collaborator

@mruberry mruberry left a comment

Choose a reason for hiding this comment

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

Thanks @mattip!

Copy link
Contributor

@facebook-github-bot facebook-github-bot left a comment

Choose a reason for hiding this comment

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

@mruberry has imported this pull request. If you are a Facebook employee, you can view this diff on Phabricator.

@facebook-github-bot
Copy link
Contributor

@mruberry merged this pull request in 8c653e0.

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

Labels

Merged open source triaged This issue has been looked at a team member, and triaged and prioritized into an appropriate module

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Build documentation without emitting warnings

6 participants