This is a good solution. I agree that maintaining multiple documents is a challenge. If all existing and previous API documentation is preserved and marked appropriately, it would be great. Obsolete or deprecated functionality could be marked appropriately.
It would be good also to have an option to filter the documentation to functionality that only exists in a certain version.
Thanks for the quick update!