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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions