Need better workmode onboarding

[cwilso]

(From suggestion by Mu-An at WHATUP)

We should ensure that feature drivers have clear pointers to the workmode, and then when/if we add the Spec Acceptance Stages that we inform feature developers of this new tool to help manage expectations.

[cwilso]

"The PR template is nice, but we should have an issue template that points to the Working Mode"

[domenic]

@muan

[annevk]

I agree we should do this, but it probably makes sense to track this over in whatwg/meta instead of here? Or do you think the SG should be involved in some way?

What I'd like to do is patch https://github.com/whatwg/spec-factory so it can push this out everywhere as well as better READMEs.

[cwilso]

No, you're probably right; I was making sure I wouldn't forget about it. I'll move it to meta.

[cwilso]

Oh: @annevk you'll have to transfer it, or give me admin rights on meta.

[annevk]

Thinking of what categories we want people to have templates for:

• New Feature
  • This would add addition/proposal and needs implementer interest as labels.
  • This would remind people of the FAQ, Working Mode, and Code of Conduct.
  • This would questions along the lines of "What problem are you trying to solve?", "What solutions exist today?", and "How would you solve it?".
  • It would direct people to Chat for questions.
• Bug
  • This would remind people of the Code of Conduct.
  • It would direct people to Chat for questions.
• Security bug (not needed for v1, but at some point we need this)

Thoughts?

[keithamus]

Would it be worth adding a template for implementer clarifications, that we might prioritise them differently (as they're likely coming from an implementer midway through work)?

[annevk]

We should probably categorize those better when triaging, but I'm not sure it helps the flow for new contributors as they might not know the difference between the various options we could offer.

I put an initial sketch up at https://github.com/annevk/temp-whatwg-new-issue/issues/new/choose (URL will disappear at some point).

[annevk]

This has now been deployed on https://github.com/whatwg/url/issues/new/choose. https://github.com/whatwg/url/#readme is also somewhat new. I'll be rolling that out to the other standards soon.

[annevk]

Remaining:

• Meta: update repository files compat#247
• Meta: update repository files html#9802
• Meta: update repository files quirks#72
• Meta: update repository files streams#1295

As noted in whatwg/spec-factory#3 (comment) there's a couple standards that need improved README's still. We could either do them manually or attempt to make them work better with spec-factory. I don't think this blocks closing this issue.

#297 tracks the remaining Stages work. I don't think that blocks closing this issue either.