Hacker News new | ask | show | jobs
by kevincox 1958 days ago
I find the circles, crosses and triangles on https://github.com/goccy/go-json#json-library-comparison hard to comprehend. I guess that circle means "yes", cross is "no" and triangle is "partial" or something. However that is really just based on context. (I guessed the symbols from what I thought the data should be)

I would suggest using words like "yes", "no" and "partial". They are short and clear. If you really want to do symbols I recommend using for yes, and still spelling out whatever triangle is supposed to mean.
2 comments
idobe 1958 days ago
The author looks to be Japanese, so that's probably why. In Japan, grade school teachers often use the symbols like so:

○ = correct × = incorrect △ = partially incorrect

I'd prefer the yes, no, partial though as well.

link
kevincox 1958 days ago
Ah, thanks for explaining that.

However yes, for an English README it probably makes sense to stick to words to clear any confusion.

link
goccy 1958 days ago
I fixed it ! Thanks !
link
mst 1958 days ago
My first thought was "yes", "no" and "ish" since the last one is a similar length to the first two.

My second thought was that that was probably just going to move the confusion to non-native english speakers.

Given a math background, ~~ for 'ish' is also tempting ... but while writing this out I've circled back around to "I can't think of anything better than partial".

link