Re:Ask HN: Is there a better way to document complex softwar...
by taeric on Monday November 26, 2018 @12:51PM
(#18535276)
That attitude is ridiculously commendable, major kudos.
My fear is typically around having "mixed edited" code. That is, code that is edited by hand and generated. I greatly prefer being able to know that the generated stuff is extended by language mechanisms and I will never really have even the ability to edit something that the generator will do. I have seen bugs in generated code, but I have always pushed to fix the generator, not just fixed the generated code. (That make sense?)
And, reiterating because I feel it is important, your position is awesome. Thanks for sharing!
My fear is typically around having "mixed edited" code. That is, code that is edited by hand and generated. I greatly prefer being able to know that the generated stuff is extended by language mechanisms and I will never really have even the ability to edit something that the generator will do. I have seen bugs in generated code, but I have always pushed to fix the generator, not just fixed the generated code. (That make sense?)
And, reiterating because I feel it is important, your position is awesome. Thanks for sharing!