Skip to content

[meta] Add guidance for how to write good new issues #12200

@justinfagnani

Description

@justinfagnani

For people who aren't regular contributors here it would be really useful to have some guidelines on how to open a good issue.

There is a lot of variation in issue titles, though an obvious common structure for most of them. Non-working group members might not know what categories to use, or whether a member will clean up the title later if it gets discussed.

Should new issues include a prefix like [proposal] or [idea]? Should "proposal" be used informally, or is it a more formal term here that includes specific choices fora change?

Likewise, with so many issues it's common for other repositories for new issues to include the search terms they used to try to find an existing issue first.

There could be an issue template, or just guidance on https://github.com/w3c/csswg-drafts/blob/main/CONTRIBUTING.md

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions