diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md index bd7579c3..18d79319 100644 --- a/.github/ISSUE_TEMPLATE.md +++ b/.github/ISSUE_TEMPLATE.md @@ -4,18 +4,21 @@ and check.) If there is no need for certain fields like output and redirection, please delete those headers before submitting. We know not all tickets require those steps. Otherwise, please try to be as detailed as possible. - + If you are unsure this is a bug in Jekyll, or this is a bug caused by a plugin that isn't directly related to Jekyll, or if this is just a generic usage question, please consider asking your question at https://talk.jekyllrb.com where non-bug questions go. - + + Please make sure to mention an affinity team whose responsibilities + most closely align with your issue. + Thanks! --> - [ ] I believe this to be a bug, not a question about using Jekyll. -- [ ] I Updated to the latest Jekyll (or) if on Github Pages to the latest `github-pages` -- [ ] I Read the CONTRIBUTION file at https://jekyllrb.com/docs/contributing/ +- [ ] I updated to the latest Jekyll (or) if on GitHub Pages to the latest `github-pages` +- [ ] I read the CONTRIBUTION file at https://jekyllrb.com/docs/contributing/ - [ ] This is a feature request. --- @@ -38,20 +41,20 @@ - [ ] I was trying to install. - [ ] There is a broken Plugin API. -- [ ] I had an error on Github Pages, and I have not tested locally. -- [ ] I had an error on Github Pages, and Github Support said it was a Jekyll Bug. -- [ ] I had an error on Github Pages and I did not test it locally. +- [ ] I had an error on GitHub Pages, and I have not tested locally. +- [ ] I had an error on GitHub Pages, and GitHub Support said it was a Jekyll Bug. +- [ ] I had an error on GitHub Pages and I did not test it locally. - [ ] I was trying to build. - [ ] It was another bug. ## My Reproduction Steps ## The Output I Wanted - +/cc include any Jekyll affinity teams here (see https://teams.jekyllrb.com/ for more info) diff --git a/docs/affinity-team-captain.md b/docs/affinity-team-captain.md new file mode 100644 index 00000000..ccdcec7a --- /dev/null +++ b/docs/affinity-team-captain.md @@ -0,0 +1,25 @@ +# Affinity Team Captains + +**This guide is for affinity team captains.** These special people are **team maintainers** of one of our [affinity teams][] and help triage and evaluate the issues and contributions of others. You may find what is written here interesting, but it’s definitely not for everyone. + +## Affinity teams & their captains + +The Jekyll project uses [affinity teams][] to help break up the work of incoming issues and pull requests from community members. We receive a sizeable number of issues and pull requests each week; the use of affinity teams helps distribute this load across a number of specialized groups instead of pushing it all onto @jekyll/core. + +## Responsibilities of Team Captains + +Each affinity team has a few captains who manage the issues and pull requests for that team. When an issue or PR is opened with a `/cc` for a given affinity team, @jekyllbot automatically assigns a random affinity team captain to the issue to triage it. They have access to add labels, reassign the issue, give LGTM's, and so forth. While they do not merge PR's today, they are still asked to review PR's for parts of the codebase under their purview. + +## How do I become a team captain? + +Just ask! Feel free to open an issue on `jekyll/jekyll` and add `/cc @jekyll/core`. We can add you. :smile: + +Alternatively, you can email or otherwise reach out to [@parkr](https://github.com/parkr) directly if you prefer the more private route. + +## Ugh, I'm tired and don't have time to be a captain anymore. What now? + +No sweat at all! Email [@parkr](https://github.com/parkr) and ask to be removed. Alternatively, you should be able to go to your team's page on GitHub.com (go to https://github.com/jekyll, click "Teams", click the link to your team) and change your status to either "member" or leave the team. + +We realize that being a captain is no easy feat so we want to make it a great experience. As always, communicate as much as you can with us about what is working, and what isn't. Thanks for dedicating some time to Jekyll! :sparkles: + +[affinity teams]: https://teams.jekyllrb.com/