In my experience, the difference between the first wave of users (the alpha geeks) and everyone else is huge. Alpha geeks are hugely passionate, they can easily digest programmers-documentation..they just get it. The group of users that comes after that is far more diverse and many of them need to be carefully and gently introduced to new technologies. For example, you might get people who want to learn Redis but won't be 100% sure about the set command from seeing something like "set users:leto '{....}'" and from reading an explanation.
The fact that I bring up duplicating values shouldn't tell you that I don't grok Redis. It should tell you that you and I differ in how we think new users will approach Redis and how the story needs to be told for them to better understand it.
I really do appreciate your feedback. Your example on set-usage is good and I'll look at adding it. But, for the rest, I think you are projecting your own understanding/knowledge onto the masses.
The fact that I bring up duplicating values shouldn't tell you that I don't grok Redis. It should tell you that you and I differ in how we think new users will approach Redis and how the story needs to be told for them to better understand it.
I really do appreciate your feedback. Your example on set-usage is good and I'll look at adding it. But, for the rest, I think you are projecting your own understanding/knowledge onto the masses.