resources icon indicating copy to clipboard operation
resources copied to clipboard

RFC: "Self-Explanatory" Considered Harmful

Open lethargilistic opened this issue 7 years ago • 0 comments

This is a list of recommendations, ostensibly targeting the users of the server, many of whom are beginners. We should be explaining why these resources are good to use, not just listing a resources and then saying the title of it or the identity of the author are all you need to know before picking something up.

  • C++ Primer Plus is definitely C++ Primer but Plus, right?
  • People use Google Allo over Discord because Google Allo is branded by Google, right?

Honestly, although it is not the ideal for a recommendations list, a blank explanation is better than one that says that it should be obvious why someone would want to read it. I think this should be in the contributing guidelines.

lethargilistic avatar Nov 06 '17 16:11 lethargilistic