News for hackers. Stuff that matters.
Re:Ask HN: Should I publish my research code? by UncleOxidant on Friday January 14, 2022 @11:30AM (#29936551)
Often the text in a paper that describes some algorithm will not be completely clear or complete. Providing the code fills in those blanks. I've taken a paper with code and gone through the code line by line comparing it with what was described in the paper. The code often ends up clarifying ambiguities. In some cases there's an outright disagreement between the paper and the code - that's where the feedback comes in, ask the author about these disagreements, it will help them clarify their approach (both the text and the code).

> Reproducing the results does not mean running the same code as the author and plotting the same figures as in the paper.

Sure, to some extent. But the code does provide a baseline, a sanity check. People who are trying to reproduce results should (as I describe above) go through both the paper and the code with a fine tooth comb. The provided code should be considered a place to start. I'll often re-implement the algorithm in a different language using the paper and the provided code as a guide.

Re:Ask HN: Should I publish my research code? by bumby on Friday January 14, 2022 @11:49AM (#29936838)
What are your thoughts on including pseudocode within the paper directly? It seems to clear up some of the ambiguities while adding brevity since it doesn't provide the somewhat frivolous details of implementation. I think it also limits some of the potential stylistic critiques.
Re:Ask HN: Should I publish my research code? by UncleOxidant on Friday January 14, 2022 @12:28PM (#29937304)
It's not a bad idea to include pseudocode, but my pet peeve is that there's really no standard for pseudocode. I tend to write pseudocode that looks like python. I did that in an internal paper for a group I worked in a few years back and the manager of the group made me change it to look more like C (complete with for loops as: for(i=0; i<x; i++) which made no sense to me).
Re:Ask HN: Should I publish my research code? by bumby on Friday January 14, 2022 @01:01PM (#29937763)
Oh, haha, then disregard my intuition that it would help avoid stylistic critiques :-)