[ThePhysicist]

I think the future are frameworks that auto-generate large parts of the documentation, possibly with small annotations that can be directly done in the code. You see this with libraries like FastAPI, which uses type annotations to auto-generate a lot of the stuff that was created manually before. I think it's the only way to keep docs in sync without expending a large amount of effort.