Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Need better workmode onboarding #296

Closed
cwilso opened this issue Sep 14, 2023 · 11 comments
Closed

Need better workmode onboarding #296

cwilso opened this issue Sep 14, 2023 · 11 comments

Comments

@cwilso
Copy link

cwilso commented Sep 14, 2023

(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
Copy link
Author

cwilso commented Sep 14, 2023

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

@domenic
Copy link
Member

domenic commented Sep 14, 2023

@muan

@annevk
Copy link
Member

annevk commented Sep 15, 2023

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
Copy link
Author

cwilso commented Sep 15, 2023

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

@cwilso
Copy link
Author

cwilso commented Sep 15, 2023

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

@annevk annevk transferred this issue from whatwg/sg Sep 15, 2023
@annevk
Copy link
Member

annevk commented Sep 22, 2023

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
Copy link
Contributor

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
Copy link
Member

annevk commented Sep 26, 2023

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 added a commit to whatwg/spec-factory that referenced this issue Sep 27, 2023
annevk added a commit to whatwg/spec-factory that referenced this issue Sep 27, 2023
@annevk
Copy link
Member

annevk commented Sep 27, 2023

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
Copy link
Member

annevk commented Sep 27, 2023

Remaining:

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.

@annevk
Copy link
Member

annevk commented Sep 27, 2023

All the issue templates have landed. See the above comment for README and Stages improvement tracking issues.

@annevk annevk closed this as completed Sep 27, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

No branches or pull requests

4 participants