Skip to content

Conversation

svekars
Copy link
Contributor

@svekars svekars commented Sep 22, 2025

This pull request introduces a new documentation build workflow, Sphinx configuration, placeholder sections, and API documentation structure. The changes automate documentation builds and previews, standardize documentation dependencies, and provide detailed module-level API references for all major components.

  • Added a new GitHub Actions workflow (.github/workflows/docs.yml) to automate building, previewing, and deploying documentation for pushes, pull requests, and manual triggers. This includes multi-version Python support, artifact uploads, and GitHub Pages deployment.
  • Added Sphinx configuration files: docs/Makefile, docs/make.bat, and docs/source/conf.py
  • Added docs/requirements.txt specifying all documentation dependencies, including Sphinx, PyTorch theme, and various extensions for enhanced documentation features.
  • Created a modular API documentation structure in Markdown for all major TorchForge modules (core, actors, data, losses, environments, controller, CLI, utilities)
  • Added a skeleton files for the rest of the docs

@meta-cla meta-cla bot added the CLA Signed This label is managed by the Meta Open Source bot. label Sep 22, 2025
@allenwang28
Copy link
Contributor

Thanks @svekars ! is it possible for me to preview the docs or does it have to be pushed first?

@svekars
Copy link
Contributor Author

svekars commented Sep 23, 2025

@allenwang28 I see somehow it ran once: https://github.com/meta-pytorch/forge/actions/runs/17960991477/job/51084022457?pr=216 - let me fix the errors there first.

@allenwang28
Copy link
Contributor

ah so the ./scripts/install.sh will probably not work in CI right now - it's pretty hyper-focused on my Dev GPU setup. I am in parallel trying to get this handled in #221

@svekars
Copy link
Contributor Author

svekars commented Sep 24, 2025

ok, I actually was able to build it. You can download the artifact here and open on your local machine to preview: https://github.com/meta-pytorch/forge/actions/runs/17963103609/job/51090348345?pr=216#step:11:24

@allenwang28 allenwang28 merged commit 0d93b06 into main Sep 24, 2025
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants