Skip to content

RFC: "Self-Explanatory" Considered Harmful #25

@lethargilistic

Description

@lethargilistic

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions