Description
Convert docs/source/tensor_view.rst from reStructuredText to MyST Markdown and ensure that doc tests pass.
Steps
-
Assign the issue to yourself using the /assigntome comment.
-
Rename the file using git mv:
git mv docs/source/tensor_view.rst docs/source/tensor_view.md
Important! Use git mv to convert the file — DO NOT delete the .rst and create a new .md.
We won't accept PRs with deleted .rst files. We want to preserve the git log.
-
Convert the content from rST to MyST Markdown syntax.
-
Build the docs locally as described in the README.
Preview locally with make serve to ensure the HTML renders correctly.
-
Run lintrunner from the root of the repository:
pip install lintrunner
lintrunner init
lintrunner -m main
-
Submit a PR with your changes and ensure the PR passes the doc CI tests. Specifically it needs to pass:
pull / linux-docs / build-docs-python-false (pull_request)
linux-jammy-py3.9-gcc11 / test (docs_test, 1, 1, lf.linux.2xlarge)
Doc tests start after the Docker build, which might take about 30 minutes.
The doc build itself should take about 25 minutes. When the build is done,
you can see the preview of your build by clicking
📄 Preview Python docs built from this PR in the pytorch-bot comment.
-
Label your PR with: docathon-2026, module: docs.
-
Compare the preview of the pages you converted with the same pages on the main branch.
The converted pages in preview must look the same as in the main branch.
-
Once the PR is accepted, one of the maintainers will merge it.
References
cc @sekyondaMeta @AlannaBurke
Description
Convert
docs/source/tensor_view.rstfrom reStructuredText to MyST Markdown and ensure that doc tests pass.Steps
Assign the issue to yourself using the
/assigntomecomment.Rename the file using
git mv:Important! Use
git mvto convert the file — DO NOT delete the.rstand create a new.md.We won't accept PRs with deleted
.rstfiles. We want to preserve the git log.Convert the content from rST to MyST Markdown syntax.
Build the docs locally as described in the README.
Preview locally with
make serveto ensure the HTML renders correctly.Run lintrunner from the root of the repository:
Submit a PR with your changes and ensure the PR passes the doc CI tests. Specifically it needs to pass:
pull / linux-docs / build-docs-python-false (pull_request)linux-jammy-py3.9-gcc11 / test (docs_test, 1, 1, lf.linux.2xlarge)Doc tests start after the Docker build, which might take about 30 minutes.
The doc build itself should take about 25 minutes. When the build is done,
you can see the preview of your build by clicking
📄 Preview Python docs built from this PR in the pytorch-bot comment.
Label your PR with:
docathon-2026,module: docs.Compare the preview of the pages you converted with the same pages on the main branch.
The converted pages in preview must look the same as in the main branch.
Once the PR is accepted, one of the maintainers will merge it.
References
cc @sekyondaMeta @AlannaBurke