I enjoyed the overall article, but if it hadn’t been curated I probably would have given up at the poker example. (Because I doubt an article where deep familiarity with poker was necessary would have been curated, and so I felt fine skipping over the word salad and looking for the general idea.) The basketball one was easy to understand albeit not really engaging for me, and the code review one felt familiar and easy. It’s hard (maybe impossible) to come up with examples that will speak to everyone, so I think having several examples is a good strategy. My only note would be to try to start with whichever example you think will be more engaging for the readers you want to attract. Of the three, I would say that is probably the Basketball one, because it’s the least technical, but this is just a guess. Alternatively, start with some kind of introductory sentence that lets the reader know that what follow are examples of a common theme.
Thank you for that feedback, I appreciate it and find it useful. Given the feedback in the comments, I now feel pretty strongly that the way I wrote that poker section was a mistake. I’m really happy that I learned this lesson though.
Yeah that also makes sense about leading with the example that is most likely to be engaging to readers. Here I feel like that’d probably be the programming example actually, but maybe not since basketball is simple enough to make sense to anyone.
I also agree with the introductory sentence being a good idea. I think I just overlooked that, actually.
I enjoyed the overall article, but if it hadn’t been curated I probably would have given up at the poker example. (Because I doubt an article where deep familiarity with poker was necessary would have been curated, and so I felt fine skipping over the word salad and looking for the general idea.) The basketball one was easy to understand albeit not really engaging for me, and the code review one felt familiar and easy. It’s hard (maybe impossible) to come up with examples that will speak to everyone, so I think having several examples is a good strategy. My only note would be to try to start with whichever example you think will be more engaging for the readers you want to attract. Of the three, I would say that is probably the Basketball one, because it’s the least technical, but this is just a guess. Alternatively, start with some kind of introductory sentence that lets the reader know that what follow are examples of a common theme.
Thank you for that feedback, I appreciate it and find it useful. Given the feedback in the comments, I now feel pretty strongly that the way I wrote that poker section was a mistake. I’m really happy that I learned this lesson though.
Yeah that also makes sense about leading with the example that is most likely to be engaging to readers. Here I feel like that’d probably be the programming example actually, but maybe not since basketball is simple enough to make sense to anyone.
I also agree with the introductory sentence being a good idea. I think I just overlooked that, actually.