Presumably it could update its own docs

Exactly. There's an autodoc feature coming up in the next version