Skip to content

Fixing documentation build #3080

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 23, 2025
Merged

Fixing documentation build #3080

merged 1 commit into from
May 23, 2025

Conversation

jgoeders
Copy link
Contributor

@jgoeders jgoeders commented May 23, 2025


Description

Readthedocs was not correctly running sphinx autodoc on our python modules because of broken imports. We were instructing readthedocs to install the docs/requirements.txt, but not the base requirements.txt. The latter includes packages that are used by our Python scripts. autodoc cannot document the Python files without having the necessary libraries available.

Related Issue

Fixes #2059

Motivation and Context

How Has This Been Tested?

Types of changes

  • Bug fix (change which fixes an issue)
  • Breaking change (fix would cause existing functionality to change)

Checklist:

  • I have added tests to cover my changes
  • All new and existing tests passed
  • My change requires a change to the documentation
  • I have updated the documentation accordingly

@jgoeders jgoeders marked this pull request as draft May 23, 2025 16:07
@github-actions github-actions bot added docs Documentation lang-python Python code labels May 23, 2025
@jgoeders jgoeders marked this pull request as ready for review May 23, 2025 16:51
@jgoeders jgoeders linked an issue May 23, 2025 that may be closed by this pull request
@jgoeders jgoeders merged commit 607788b into master May 23, 2025
37 checks passed
@jgoeders jgoeders deleted the docs-fix branch May 23, 2025 18:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation lang-python Python code
Projects
None yet
Development

Successfully merging this pull request may close these issues.

VTR flow library documentation is just a skeleton -- should fill in
1 participant