I'm against compiled stuff going into version control, specially when it comes to compiled binaries, however, my principles are now in question after adding doxygen support for a project.

Should the hundreds of files generated by doxygen go into version control?, what is the recommended practice here?, I think the ideal would be automating the process in a server that publishes that documentation at the same time, however, there is no such server now nor there will be for some time.

  • Ask yourself: What value does it add, and what does it cost? In general, it clutters repo history forever, and builds (including the documentation) should be reproducable by a single command anyway, so there ought to be little value. Plus, you can host the documentation on a shared network drive or something.
    – user7043
    Nov 13, 2012 at 21:37

1 Answer 1



Keep everything that you need to rebuild anything else. If it's auto-generated then you can go back to any point in the history of your repository and build it again. Why keep it?

  • 1
    Bingo. Anything you can generate should be treated like object code and should go away when you make clean.
    – Blrfl
    Nov 13, 2012 at 21:47

Not the answer you're looking for? Browse other questions tagged or ask your own question.