keeping the generated bits separated out from hand-written code makes it less likely
that somebody’s custom-crafted source will get clobbered by accident when the
generated bits get re-generated. XML forms a nice middle ground between
something that is easy for tool-writers to use and easy for programmers to work with
by hand as needed