Skip to content

Fix llms-full.txt generation hang and add option to disable it#245

Open
svekars wants to merge 3 commits intopytorch_sphinx_theme2from
fix-llms-full-generation
Open

Fix llms-full.txt generation hang and add option to disable it#245
svekars wants to merge 3 commits intopytorch_sphinx_theme2from
fix-llms-full-generation

Conversation

@svekars
Copy link
Copy Markdown
Contributor

@svekars svekars commented Apr 13, 2026

  • Switch from ProcessPoolExecutor to ThreadPoolExecutor for parallel markdown generation, fixing a deadlock that caused llms-full.txt to be partially generated and the build to hang in large projects like PyTorch
  • Add new llm_generate_full theme option to allow large projects to skip llms-full.txt generation entirely while still producing individual .md files and llms.txt
  html_theme_options = {                                    
      "llm_generate_md": "true",                                                                                                              
      "llm_generate_full": "false",  # Skip llms-full.txt
  }                                                                                                                                           

Defaults to "true".

Test plan

  • Build docs with llm_generate_full = "true" (default) — verify llms-full.txt is generated
  • Build docs with llm_generate_full = "false" — verify llms-full.txt is not generated, individual .md files still are
  • Build does not hang on large doc sets (e.g., PyTorch)

@meta-cla meta-cla bot added the cla signed label Apr 13, 2026
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 13, 2026

Deploy Preview for pytorchsphinxtheme ready!

Name Link
🔨 Latest commit 5b3b241
🔍 Latest deploy log https://app.netlify.com/projects/pytorchsphinxtheme/deploys/69dd7a728b0fbd00080cec2e
😎 Deploy Preview https://deploy-preview-245--pytorchsphinxtheme.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant