Advice on writing puzzle instructions

[Egubachu]

Hello Egubachu,

I looked at your puzzle and the rules are clear. The commenter said he had trouble understanding your Solution Code description, not the puzzle's rules. In my opinion the solution code description is also well worded with an example, however, the question is if such an extra rule is necessary. Considering the grid is relatively minimal, it is pretty unlikely that someone will come across the solution without being able to find the magic squares anyway, so just asking for Row 6 probably is enough.

With that being said, I think you did a good job with the presentation of the puzzle, both in rules and the solution code. The commenter probably got confused because usually you do not "draw" the magic square into the grid.

Hi Niverio,

Thank you so much for your thoughtful comments. I agree indeed that my solution code description was more complicated than necessary. I'll keep it simple for my future puzzles.

Btw, thank you also for your encouraging comments about the Crossroads puzzle, that had multiple solutions. I am trying to fix it in such a way that the puzzle won't just collapse too soon, because I feel like this puzzle deserves a well thought-out logical path. I thought I had it, of course, but I must have missed a possibility somewhere in my logic. The black dots were really intentional where they were, and they do certainly give you digits. Just not directly at the black dots I'm a bit bummed though that they didn't fully disambiguate the puzzle like I thought they would.

All the best!