For documentation, the Github site is the best:
https://github.com/adobe-photoshop
Generator is open source, so Adobe uses github to post documentation and issues (as well as all the sources)
I wouldn't recommend trying to modify the document when responding to events for the reasons you mention. Generator isn't really designed for that. At the very least, you should be parsing the change (e), and only reacting to a specific change that isn't the change you are making.
You might look at the generator-assets source on github for some ideas on that.