Post

12 replies
J
As a remote non-US employee of a US company Thanksgiving for me is side-project day. Today I'm going to be hacking on an LLM plugin for Sphinx. I'm most interested in generating summaries of content for cross-referencing during the documentation build step. I'm going to live-post here as I go!
19,321,360 views
8
J
Replying to @jacobtomlinson
This project was hugely inspired by Aarti Jha's talk at PyData NYC "The Art of Compression: Crafting Insightful Summaries with LLMs" www.youtube.com/watch?v=kCCC...
5,200 views
J
Replying to @jacobtomlinson
I've started a new repo and used `hatch init` to create the boilerplate structure. I'll push code there frequently today. github.com/jacobtomlins...
5,200 views
J
Replying to @jacobtomlinson
I've created some sample documentation with sphinx-quickstart and then I'm using sphinx-autobuild to rebuild the docs every time I make a change. I'm also using uv to keep dependency management clean. www.sphinx-doc.org/en/master/us... pypi.org/project/sphi... github.com/astral-sh/uv
5,200 views
J
Replying to @jacobtomlinson
I'm going to need some boilerplate documentation to start summarising. This feels like a good use case for Copilot to hallucinate some entertaining nonsense.
5,200 views
J
Replying to @jacobtomlinson
I have a very basic sphinx extension written out now. I can add a custom admonition called docref which will link to another page and include a summary. Right now the summary is hand written and it doesn't link though.
5,200 views
Replies
J
Replying to @jacobtomlinson
Ideally I want to be able to attach a debugger during the build. I use VS Code so let's hook up the sphinx build to the debugger. Calling `sphinx-autobuild` is functionally the same as `python -m sphinx_autobuild` so we can use the Python Module debugger to invoke it.
5,200 views