website
website copied to clipboard
Create wiki pages describing merge team/dev lead tasks
Overview
We need a wiki page describing merge team/dev lead tasks, to expedite onboarding and increase merge team engagement
Action Items
- [x] We are currently in the process of moving the old wiki to the new website-wiki repo, so we will not be making any changes or additions to the old wiki at this time. Thus, we will be adding wiki content through a different process now. Read How to Contribute to the Wiki
- [x] Create a wiki page with the following sections:
- [x] review onboarding prework issues
- [x] review prework issues in progress
- [x] review
2 weeks inactive
issues (excluding prework issues) - [x]
Questions/In Review
column - [x]
Help Wanted
review - [ ]
New Issue Approval
- [ ]
ready for merge team
review - [ ]
ready for dev lead
review - [ ] leading onboarding meetings
- [ ] leading Tuesday dev-only meetings
- [ ] leading Thursday office hours
- [ ] leading Sunday dev/PM meetings
- [ ] dependabot issues
- [ ] escalation of Slack questions
- [ ] escalation of PR problems
Resources/Instructions
https://docs.google.com/spreadsheets/d/1phPsEd_RVjQlHI4hsPJVEqqi4Ua-4WI7lhXNggtuc24/edit#gid=664707926
Hi @roslynwythe.
Please don't forget to add the proper labels to this issue. Currently, the labels for the following are missing:
- Complexity, Role, Feature, Size
NOTE: Please ignore this comment if you do not have 'write' access to this directory.
To add a label, take a look at Github's documentation here.
Also, don't forget to remove the "missing labels" afterwards. To remove a label, the process is similar to adding a label, but you select a currently added label to remove it.
After the proper labels are added, the merge team will review the issue and add a "Ready for Prioritization" label once it is ready for prioritization.
Additional Resources:
Review onboarding prework issues
During onboarding, prework issues (which have the label `Complexity: Prework) need to be checked to ensure the following are correct:
- [ ] developer has completed a row in the roster
- [ ] developer's name is in the title
- [ ] developer is a public member of Hack for LA (confirm by hovering over GitHub handle)
- [ ] developer assigned to issue
- [ ] developer has assigned
role: frontend
,role: back end/devOps
or both - [ ] issue is on the Project Board
- [ ] there are no
Missing
labels If any of the above are incorrect, create a comment asking the dev to fix the problem. When all the above are correct, do the following: - [ ] assign the milestone
08. Team workflow
- [ ] move the issue to the
In Progress
column - [ ] add the developer's name to https://github.com/hackforla/website/issues/3175
Review prework issues in progress
- [ ] Check for comments from the developer indicating that they need help
- [ ] If a developer is waiting for an issue of a particular complexity, do the following:
- [ ] Provide shortcut link for sorting the Project Board for appropriate issues
- [ ] Apply the appropriate "needs" label (e.g "needs issue: medium")
- [ ] Suggest that while waiting for an issue, they can create issues. Suggest that they check the column "ERs and Epics that are ready to be turned into issues"
- [ ] If the developer is going on a hiatus, move the issue to `Questions/In Review'
- [ ] The prework issue is closed when the developer is no longer active in HackforLA
Review 2 weeks inactive
issues (excluding prework issues)
- [ ] Review
2 weeks inactive
issues in theIn Progress
column:- [ ] Read issue comments to determine if the developer needs assistance
- [ ] Check the roster to make sure that the developer is still active with the project. If not, unassign the developer and skip to the action "After unassigning the developer from an issue" below
- [ ] Create a comment requesting a progress update. There should be a recent bot comment that the developer can refer to for the required elements of a progress update.
- [ ] Indicate that if the developer does not provide an update before a specific deadline, they will be unassigned from the issue. For a time-sensitive issue, the deadline should be in a few days. For other issues, the deadline can be longer, especially if it is a larger issue and the developer has clearly done a lot of work on the issue.
- [ ] If the deadline has passed, unassign the developer from the issue
- [ ] After unassigning a developer from an issue, move the issue to
New Issue Approval
and apply theready for dev lead
label so that it can be prepared for prioritization - [ ] To prepare the issue for prioritization
- [ ] clean up the comments, hiding any comments that are outdated
- [ ] consider whether the issue was confusing or should be labelled with a different complexity label. Make required changes to address those problems. Also edit as needed, for instance to uncheck Action Item checkboxes
- [ ] apply the
ready for prioritization
label
- [ ] Review
2 weeks inactive
issues in other columns- [ ] Read issue comments to determine if the developer needs assistance
- [ ] Check the roster to make sure that the developer is still active with the project. If not, unassign the developer and skip to the action "After unassigning the developer from an issue" above
- [ ] Create a comment requesting a progress update. There should be a recent bot comment that the developer can refer to for the required elements of a progress update.
Questions/In Review column
- [ ] Use this shortcut linkto display the Questions/In Review column https://github.com/hackforla/website/projects/7#column-8178690
- [ ] Focus on issues with
ready for dev lead
label. Ignore issues withready for product
label. - [ ] If comments indicate that the developer has a blocker, provide assistance as needed. If you are unable to answer a question, refer the developer to another merge team member or the dev lead. When the developer is able to resume work on the issue, move the issue back to
In Progress
and removeready for dev lead
label if it was applied - [ ] Perform a review if required. For example, for an auditing issue, the action items will often call for the assignee to populate information on a spreadsheet or in a comment in the issue. Examine such results for completeness and accuracy. When complete, create a comment and close the issue "as completed". If changes are requested, remove the
ready for dev lead
label and instruct the developer to apply that label after the requested changes are complete or if more help is needed. - [ ] If comments indicate that the developer was on hiatus, and the planned date of return has passed, create a comment requesting a status update
Help Wanted review
- [ ] Use this shortcut link to locate issues with the `Status: Help Wanted" label https://github.com/hackforla/website/projects/7?card_filter_query=label%3A%22status%3A+help+wanted%22
- [ ] Focus on items in
In Progress
orQuestions/In Review
- [ ] Provide assistance as needed. If you are unable to answer a question, refer it to another merge team member or to the dev lead. If help is needed from the product team, suggest that the developer bring the issue to a Sunday All-team meeting. If you are able to answer a question, then remove the
Status: Help Wanted
label
Why is this issue closed?
Why is this issue closed?
I have no idea. I reopened it.
@roslynwythe is this issue done? Do you want me to put this in progress?
@ExperimentsInHonesty If the action items look good to you, please prioritize. I've already completed the items through "Help Wanted review" so comments/corrections on those would be welcome, otherwise I'll continue with the remaining items.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, April 16, 2024 at 12:06 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, April 23, 2024 at 12:06 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, April 30, 2024 at 12:06 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, May 7, 2024 at 12:06 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, May 14, 2024 at 12:06 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, May 21, 2024 at 12:06 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, May 28, 2024 at 12:06 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, June 4, 2024 at 12:06 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, June 11, 2024 at 12:06 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, June 18, 2024 at 12:06 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Wednesday, June 19, 2024 at 1:48 PM PST.
Divide these responsibilities up into complexity levels
- Small
- Medium
- Large
review onboarding prework issues review prework issues in progress review 2 weeks inactive issues (excluding prework issues) Questions/In Review column Help Wanted review New Issue Approval ready for merge team review ready for dev lead review leading onboarding meetings leading Tuesday dev-only meetings leading Thursday office hours leading Sunday dev/PM meetings dependabot issues escalation of Slack questions escalation of PR problems
Merge Team 1 (peer mentor)
review onboarding prework issues preview prework issues in progress review 2 weeks inactive issues (excluding prework issues) merging GFI, small and Medium PRs Continue work on Issue Making Checklist
Merge Team 2 (merge team member)
leading onboarding meetings leading other dev meetings reviewing and answering questions posted in Slack channels (see escalation if unable to answer) escalation of Slack questions reviewing and answering questions posted in PR (see escalation if unable to answer) escalation of PR problems Reviewing Large and XL PRs Continue work on Issue Making Checklist
Merge Team 3 (senior merge team member)
New Issue Approval with label: ready for merge team
ER column review with label ready for merge team
escalated Help Wanted (possibly removing this because help wanted label not working)
reviewing and answering questions posted in the questions/review (see escalation if unable to answer)
escalated Questions/In Review
merging Large and XL PRs
Continue work on Issue Making Checklist
Dev Lead
New Issue Approval with label: ready for dev lead
Dependabot
Architecture decisions
Roll out plans (IM: 5)
New Issue Approval
Go though the "New Issue Approval" column of the Project Board, looking at each issue with ready for dev lead
or ready for merge team
label. For each issue:
- [ ] Verify that the issue is clear, complete and will solve the necessary problem
- [ ] Confirm that guidance is given for testing as needed
- [ ] If the issue will not be resolved by a PR, specify the process for review.
- [ ] Confirm that the proper Resources are listed, including reference to any ER.
- [ ] If all the above are satisfied, remove
ready for dev lead
orready for merge team
and addready for prioritization
ERs
Go though the "ER" column of the Project Board, looking at each issue with ready for dev lead
or ready for merge team
label. For each issue, we need to determine if the ER is ready for issue making.
- [ ] Verify that the request (or requirement/problem/bug) is documented clearly and completely
- [ ] Review the proposed solution (draft) and determine if it is a reasonable approach for an issue to resolve the request
- [ ] Confirm that the ER labels are correct.
- [ ] The
ER
label should be applied as well asComplexity: See issue making label
- [ ] In addition,
role
andComplexity
labels should be applied that describe the proposed issue(s).
- [ ] The
- [ ] If any of the above is not satisfied, leave a comment and remove
ready for dev lead
orready for merge team
. If all the above are satisfied, removeready for dev lead
orready for merge team
and addready for prioritization
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, July 30, 2024 at 12:05 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, August 6, 2024 at 12:04 AM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, August 13, 2024 at 12:14 PM PST.
@roslynwythe
Please add update using the below template (even if you have a pull request). Afterwards, remove the '2 weeks inactive' label and add the 'Status: Updated' label.
- Progress: "What is the current status of your project? What have you completed and what is left to do?"
- Blockers: "Difficulties or errors encountered."
- Availability: "How much time will you have this week to work on this issue?"
- ETA: "When do you expect this issue to be completed?"
- Pictures (optional): "Add any pictures of the visual changes made to the site so far."
If you need help, be sure to either: 1) place your issue in the Questions/In Review
column of the Project Board and ask for help at your next meeting, 2) put a "Status: Help Wanted" label on your issue and pull request, or 3) put up a request for assistance on the #hfla-site channel. Please note that including your questions in the issue comments- along with screenshots, if applicable- will help us to help you. Here and here are examples of well-formed questions.
You are receiving this comment because your last comment was before Tuesday, August 27, 2024 at 12:04 AM PST.