News for hackers. Stuff that matters.
Re:Show HN: Comgra: A library for debugging and understandin... by godelski on Wednesday September 06, 2023 @11:36AM (#37406677)
Looks like a cool project.

But a pet peeve of mine is when READMEs don't have full working examples. Totally okay when in alpha, but nice to have when posting somewhere. The other part of this is that when notebooks are included, that they have their full outputs and no errors (looking at you `single_test_0.ipynb`)

At least to me, it isn't clear what the project does, how I use it, and what my outputs look like. Images always sell the show. Gifs are great when demonstrating tools, or videos are better (because I can pause it!). The main image here really doesn't tell me much, just that there are some different color rectangles.

Re:Show HN: Comgra: A library for debugging and understandin... by p1esk on Wednesday September 06, 2023 @12:23PM (#37407356)
I agree, examples would help. Preferably not in notebooks. Especially examples of you found a problem with this tool.