Live data from Hacker News

Comic Code Reviews

jona.ca

11–20 of 37 posts

Re: Comic Code Reviews

#11
post #9

Earlier quoted context omitted.

It's valuable to make a difficult task easier, even for those who could do the task without the help.

I'd rather just have a high-level summary in English for that. This seems to take dumbing-down beyond any sensible level.

People who dumb down seem to think it's easier to be dumb. Not everyone seems to agree, fortunately.

Re: Comic Code Reviews

#12

I’ve been experimenting with a way to make code reviews more understandable - turning tricky pull requests into short comic strips. The blog post shows an example generated from a real PR: summarizing the changes, anthropomorphizing the components, and making the flow visually obvious. It’s meant to help reviewers grasp intent quickly and make reviews a bit more fun. Curious whether others have tried visual or narrat…

I really like the idea... but I have to admit my first visceral reaction was "I hate this". I think it's because the tone and style is quite infantile/childish. A good experiment nonetheless. Maybe there's a middle ground somewhere?

Re: Comic Code Reviews

#14

I’ve been experimenting with a way to make code reviews more understandable - turning tricky pull requests into short comic strips. The blog post shows an example generated from a real PR: summarizing the changes, anthropomorphizing the components, and making the flow visually obvious. It’s meant to help reviewers grasp intent quickly and make reviews a bit more fun. Curious whether others have tried visual or narrat…

I really like the idea... but I have to admit my first visceral reaction was "I hate this". I think it's because the tone and style is quite infantile/childish. A good experiment nonetheless. Maybe there's a middle ground somewhere?

What’s your line for “childish“?

I’ve been guilty of injecting bits of whimsy, sarcasm, and other unserious behaviors in a corporate We Mean Business environment.

I’ve toned it down because I recognize some people are very resistant to seeing both the serious and humorous aspects of a situation at the same time.

Re: Comic Code Reviews

#17

I’ve been experimenting with a way to make code reviews more understandable - turning tricky pull requests into short comic strips. The blog post shows an example generated from a real PR: summarizing the changes, anthropomorphizing the components, and making the flow visually obvious. It’s meant to help reviewers grasp intent quickly and make reviews a bit more fun. Curious whether others have tried visual or narrat…

Using visual approaches, including comics, is a reasonable idea I've been looking into personally as well (mostly using style transfer from manga). :)

But, the actual concepts communicated need to be clear. In your example strip here, it doesn't seem to be meeting that bar for a reviewer. :(

Keep at it though, as I get the feeling this is the kind of thing that will work after a few important "aha!" ideas and tweaks happen to the generating process. :)

Re: Comic Code Reviews

#18

I’ve been experimenting with a way to make code reviews more understandable - turning tricky pull requests into short comic strips. The blog post shows an example generated from a real PR: summarizing the changes, anthropomorphizing the components, and making the flow visually obvious. It’s meant to help reviewers grasp intent quickly and make reviews a bit more fun. Curious whether others have tried visual or narrat…

I'm not against it, but this particular strip seemed a little incoherent. It might need manual storyboarding.

Re: Comic Code Reviews

#19

Interesting idea but unfortunately the given example comic makes very little sense. It was difficult to parse even as someone who's familiar with these concepts, and I think it will hurt more than help any newbies.

Exactly my thought. Can anyone here say otherwise?

Re: Comic Code Reviews

#20

Interesting idea but unfortunately the given example comic makes very little sense. It was difficult to parse even as someone who's familiar with these concepts, and I think it will hurt more than help any newbies.

Exactly my thought. Can anyone here say otherwise?

I didn't have any trouble with the comic but I do already know these things about how react hooks work so I'm not going in fresh.

I think it's a little whimsical, perhaps too much for what info it conveys (a bullet list with the same component names would probably be equally informative), but I thought it was easy to understand and follow. I think there is -something- here; I don't need THIS comic but if it was more about the context and goals of the change then maybe that would be powerful. Especially if it was consistently done over many PRs.

Post reply on HN