3 ms·
Agreed. I experimented with autogenerating C4 diagrams from source a while back, but quickly abandoned the project when I realized that the output was inevitabl
by mumblemumble 3y ago
Agreed. I experimented with autogenerating C4 diagrams from source a while back, but quickly abandoned the project when I realized that the output was inevitably the flowchart equivalent of
bool mystery_func(int i) { // define a new function
int x = (int)(i / 2); // x is i divided by 2 and truncated
int y = x * 2; // y is twice x
return y == i; // return true if y == i
} // end of function
- nuancebydefault 3y agoIndeed, the documentation (diagrams/text with particular layout and formatting) should abstract a lot of what the code does. Otherwise, what's the point since the code is there for you to read. In my experience, auto-generated documentation in general does a poor job. That said, such automation is improving by virtue of better AI, that understands and cross translates people's languages and computer languages.