Skip to content

Structure alternatives as: Alternative → Pros → Cons → Reason for rejection. #34

@jyasskin

Description

@jyasskin

Thanks to @toreini for the suggestion. Otherwise we get sections like https://github.com/explainers-by-googlers/script-src-v2/blob/main/README.md#considered-alternatives that mix the definition of the alternative with its disadvantages, and often don't mention advantages at all.

We should consider whether Pros/Cons or Advantages/Disadvantages is more in line with https://github.com/w3ctag/process/blob/main/style-guide.md.

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