pytorch/functorch/docs
Xuehai Pan 740fb22966 [BE][Easy][4/19] enforce style for empty lines in import segments in functorch/ (#129755)
See https://github.com/pytorch/pytorch/pull/129751#issue-2380881501. Most changes are auto-generated by linter.

You can review these PRs via:

```bash
git diff --ignore-all-space --ignore-blank-lines HEAD~1
```

Pull Request resolved: https://github.com/pytorch/pytorch/pull/129755
Approved by: https://github.com/zou3519
ghstack dependencies: #129752
2024-07-18 05:08:03 +00:00
..
source [BE][Easy][4/19] enforce style for empty lines in import segments in functorch/ (#129755) 2024-07-18 05:08:03 +00:00
.gitignore
Makefile [functorch] GHA docs build; nbsphinx -> myst-nb (pytorch/functorch#517) 2022-07-21 13:41:22 -07:00
README.md [functorch] Switched docs theme to pytorch-theme (pytorch/functorch#453) 2022-07-21 13:41:21 -07:00

functorch docs build

Build Locally

Install requirements:

pip install -r requirements.txt

One may also need to install pandoc. On Linux we can use: sudo apt-get install pandoc. Or using conda we can use: conda install -c conda-forge pandoc.

To run the docs build:

make html

Check out the output files in build/html.

Deploy

The functorch docs website does not updated automatically. We need to periodically regenerate it.

You need write permissions to functorch to do this. We use GitHub Pages to serve docs.

  1. Build the docs
  2. Save the build/html folder somewhere
  3. Checkout the branch gh-pages.
  4. Delete the contents of the branch and replace it with the build/html folder. index.html should be at the root.
  5. Commit the changes and push the changes to the gh-pages branch.