News for hackers. Stuff that matters.
Re:Developers should be force-fed state machines (2011) by JohnFen on Thursday April 20, 2023 @12:26PM (#35642425)
I would hate this so much!

I can see how an actual image is useful in certain circumstances, but I wouldn't want it to appear in the code itself. Just include the image in the documentation folder and refer to it in the code by name.

Re:Developers should be force-fed state machines (2011) by criddell on Thursday April 20, 2023 @12:46PM (#35642702)
It's been invaluable to me in a few circumstances. A common one is when there is a diagram of a physical object with dimensions and the dimensions are used in the code. For example, say you are doing a volume calculation of a complex enclosed space that uses quantities like length, height, clearance, diameter, etc... A diagram illustrating what those dimensions are can aid immensely in understanding the code.
Re:Developers should be force-fed state machines (2011) by JohnFen on Thursday April 20, 2023 @12:57PM (#35642863)
Oh, sure, it can be extremely helpful. A picture is worth a thousand words and all of that. I just don't want that picture in-line with the code. It bulks up the view of the code and I'd want the picture in a separate window anyway, to refer to it as I'm scrolling through the code itself.