[flukus]

I don't care so much about the documentation, as long as it's part of the build script (it's own documentation) and not checked into source control. By not checking it into source control it won't be edited, there won't be a mix of generated and custom code. By being part of the build process you avoid the generation tool and scripts being lost to the sands of time.

[quickthrower2]

I like the build process to be committed personally for build reproducibility. It can be in a seperate more secured repository though.