Pre-work Checklist: Developer: Matthew Chau

[MattChau01]

Prerequisite

We are looking forward to having you on our team. Please make sure to attend the general Hack for LA onboarding to get the process started https://meetup.com/hackforla/events.

Overview

As a new developer on the HfLA website team, fill in the following fields as you complete each onboarding item.

Special Notes

1. It may take you a few weeks to finish this issue, because part of it is learning how to provide updates on issues that take more than a week to complete. Please keep this issue open until you have been able to do all the steps.
2. Usually we don't want to you have more than one issue assigned to you at a time, this issue is the exception, because it is instructions on how to work on other issues.
3. The action items listed below should mostly be worked on in a sequential order. However, you don't have to wait on one if you can proceed with the others, For instance, you don't have to wait for attending a weekly meeting before setting up your dev environment.

Action Items

• Add yourself to the #hfla-site and #hfla-site-pr Slack channels
• Share your GitHub handle and Gmail address in the hfla-site-onboarding slack channel so you can be added to the Google Drive (alternative to go to meeting and direct message a merge team member at the meeting)
  • To find contact information for the merge team members and technical leads, please take a look at our Meet the Team wiki page
• Also, confirm with a merge team member or a technical lead that they have added you to the Google Calendar invites for our Zoom meetings
• (Once added to the Drive) Add yourself to the team roster
• After you have finished adding yourself to the roster, let a merge team member or a technical lead know you have added yourself to the roster and would like to be added to the website-write and website teams on GitHub
• Once added to the website-write team:
  • Self Assign this issue (gear in right side panel)
  • Add the "role: front end" or "role: back end" or both label(s) to this issue and remove the "role missing" label (gear in right side panel)
  • Add this issue to the Project Board under the Projects section (gear in right side panel)
• Signup for a Figma account
• Attend weekly team meetings:
  • Developer (front-end/back-end) weekly team meeting, Tuesdays 7-8pm PST
  • (Optional) Office Hours, Thursdays 7-8pm PST
  • All team meeting (UX, Development, Product), Sunday 10am-12pm PST
• Note: There are no meetings on the 1st-7th of every month.
• Note regarding weekly team meeting requirements: All website team members are required to attend at least 1 team meeting in a week (held on Tuesdays, Thursdays and Sundays). In case, you are unable in any given week, you should reach out to the tech leadership team. Exceptions to this requirement may be provided on a case-by-case basis. Also, please let the tech leadership team know (through a slack message in the hfla-site channel as well as an @ mention in a comment of the issue that you would be working on) if you are planning to take a week off or a longer vacation.
• Complete steps 1.1 - 1.6 in Part 1: Setting up the development environment within Contributing.md
  • OPTIONAL: If you run into any issues, use 4.1 How do I ask for help within Contributing.md as a visual example to get a hold of our HfLA website leadership team. That way we can help you resolve any set up issues immediately.
• Read section 2.1 - 2.4 in Part 2: How the Website team works with GitHub issues within Contributing.md
  • Follow the steps in section 2.3 Where can I find GitHub issues to work on? to assign yourself your first issue under the Project Board's Prioritized Backlog column and use 2.7 Working on a Issue within Contributing.md to start working on your issue
  • Read 2.6 What to do when you need to stop mid issue
• Once you take a good first issue, you will provide estimates and progress reports. Also, once you finish providing your "Estimate" action item below, please answer the question in the "Time spent so far" action item (also below).
  • Estimate: Copy the below and put it in the "good first issue" that you picked.
    Check this box when you have completed this task so that we can identify if you understood the instructions and know what to do on all subsequent issues upon assignment. (Note: Please provide estimates on all the issues that you pick up, going forward.)

  Availability for this week:
  My estimated ETA for completing this issue:
  

  • Time spent so far: Copy the question below into a new comment below (in this pre-work issue only) and answer it. This is just to get feedback on how long it took you to get to this point on this pre-work. There is no right or wrong answers. There is no judgement. It is ok if you take a long time or if you do it really fast or at any pace.

  How many hours did it take you to finish the pre-work up to and including adding your initial ETA and availability for your good first issue, including attending your first meetings?
  

  • Progress Reports: Copy the below and put it in the issue once you have been assigned to the issue at least 5 days (we check weekly on Fridays), or sooner if you have something to report. If you finish this issue before 5 days are reached, Yeah!!, do it on your next issue. This update should be done every week for every issue that you are assigned to. The checkbox here is meant for us to see if you understood the instructions when you end up doing your first weekly progress update.

  Provide Update
  1. Progress
  2. Blockers
  3. Availability
  4. ETA
  

• Read sections 3.1.a - 3.1.c in 3.1 How to make a pull request to learn more about how to make a pull request (PR) for the issue that you are working on and how to make changes to your PR if changes are requested by the reviewer
• Additional notes:
  • Please don't forget to review pull requests whenever you are able to. The How to review Pull Requests guide will teach you how to review pull requests.
  • Please work on only one issue at a time and wait until your pull request is merged before picking up another issue.
• Read and understand how we progress through issues. Then, you can check this off.
  Progress through issues in the prioritized backlog only with increasing complexity in the following order:
  • Good first issue (one per person)
  • Good second issue (one per person)
  • Small (one per person, with some exceptions, see below)
  • Medium (you can work on more than one medium issue, but only one at a time)
  • Large (you can work on more than one large issue, but only one at a time)
    • The reasons for this progression are:
      • The issues start out as being prescriptive and become less so as you gain more experience by working through increasingly complex issues.
      • We are trying to teach you the team methodology through the issues themselves.
      • It ensures you understand what we expect and the quality of contributions.
    • You can work on back-to-back small issues if it meets the following criteria:
      • You are learning something new and need to work on an issue of a lesser complexity
      • Special request by a lead or pm
• Read the Start Here - Developers in Figma
• Go familiarize yourself with the Hack for LA Design System page in Figma (where you can see components and their SCSS classes)
• Once all tasks are completed, close this issue. This issue will remain open until you get through your first progress report. Once you have done that, we are confident you know how to keep the momentum going on your issue and keep your team informed.

What should I do if I have a question about an issue I'm working on, and I haven't gotten a response yet?

• First, you should post the question or blocker as a comment on your assigned issue, so it can be easily referred to in the next bullet points.
• Then, add the label "Status: Help Wanted" so other developers can see it and potentially help answer your question. In addition, you will still need to post a Slack message or bring it up in meeting so we know you need help; see below for how to do that.
• Also, you can post your question on the hfla-site slack channel and link the issue you're working on, so other developers can see and respond.
• Lastly, you can add the issue to the "Development team meeting discussion items" column of the Project Board so that it can be addressed in the next development meeting. Please bring it during the meeting that you need help.

Resources/Instructions

• Contributing.md - Hack for LA
• GitHub Project Board - Hack for LA
• GitHub Project Board Prioritized Backlog highlighted and sorted by Front End
• GitHub Project Board Prioritized Backlog highlighted and sorted by Back End/DevOps
• Figma - Hack for LA
• Google Drive - Hack for LA website team
• Agenda / Notes - Dev Team Tuesday meeting
• Agenda / Notes - All Team meeting
• How to review Pull Requests

[github-actions]

@MattChau01

Please add update using the below template (even if you have a pull request). Afterwards, remove the 'To Update !' label and add the 'Status: Updated' label.

1. Progress: "What is the current status of your project? What have you completed and what is left to do?"
2. Blockers: "Difficulties or errors encountered."
3. Availability: "How much time will you have this week to work on this issue?"
4. ETA: "When do you expect this issue to be completed?"
5. 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 25, 2023 at 12:15 AM PST.}

[MattChau01]

How many hours did it take you to finish the pre-work up to and including adding your initial ETA and availability for your good first issue, including attending your first meetings?

It took me approximately 4 accumulated hours to assign my good first issue, attending meetings and finishing pre-work items up until this bullet.

[MattChau01]

1. Progress: I am currently waiting on my second review on Updated meeting day on cop-engr #5003. #5112 for issue COP page, Engineering section: Update meeting day #5003. Once branch is merged, I will be looking into a small issue to work on next.
2. Blockers: No blockers yet.
3. Availability: I am available for the most part in terms of communication, and will be available on the weekend to work on any additional fixes.
4. ETA: Expected to have reviews finished by end of wekeend.
5. Pictures: Updated meeting date from Wednesday to Thursday.

[github-actions]

@MattChau01

Please add update using the below template (even if you have a pull request). Afterwards, remove the 'To Update !' label and add the 'Status: Updated' label.

1. Progress: "What is the current status of your project? What have you completed and what is left to do?"
2. Blockers: "Difficulties or errors encountered."
3. Availability: "How much time will you have this week to work on this issue?"
4. ETA: "When do you expect this issue to be completed?"
5. 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 8, 2023 at 12:06 AM PST.}

[MattChau01]

1. Progress: Currently, I am working on Issue Audit for img tags ending with a slash in file: _layouts/project.html #5009. I left a comment for @roslynwythe on whether actual code would be needed to changed and pushed. Otherwise, I have completed the other steps specified on the issue.
2. Blockers: No blockers on my end, just waiting to hear back on the issue.
3. Availability: I will be available to work on the issue Saturday Morning and Most of Sunday.
4. ETA: I'm looking to have this issue completed by end of day Sunday.

[MattChau01]

Progress: I've been assigned to review pull requests: #5263 and #5283.
Blockers: No blockers as of yet.
Availability: I will have time in the evening today, Thursday and most of the weekends.
ETA: I'm expecting to complete these reviews by EoD Friday.

[github-actions]

@MattChau01

Please add update using the below template (even if you have a pull request). Afterwards, remove the 'To Update !' label and add the 'Status: Updated' label.

1. Progress: "What is the current status of your project? What have you completed and what is left to do?"
2. Blockers: "Difficulties or errors encountered."
3. Availability: "How much time will you have this week to work on this issue?"
4. ETA: "When do you expect this issue to be completed?"
5. 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 29, 2023 at 12:06 AM PST.}

[MattChau01]

Progress: The last item I've worked on is a pull request review on #5344. The pull request has already been merged, and will be looking to attend the next standup to pick up another pull request to review.
Blockers: No blockers.
Availability: My availability is usually weekday evenings.

[github-actions]

@MattChau01

Please add update using the below template (even if you have a pull request). Afterwards, remove the 'To Update !' label and add the 'Status: Updated' label.

1. Progress: "What is the current status of your project? What have you completed and what is left to do?"
2. Blockers: "Difficulties or errors encountered."
3. Availability: "How much time will you have this week to work on this issue?"
4. ETA: "When do you expect this issue to be completed?"
5. 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, September 12, 2023 at 12:06 AM PST.}

[github-actions]

@MattChau01

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.

1. Progress: "What is the current status of your project? What have you completed and what is left to do?"
2. Blockers: "Difficulties or errors encountered."
3. Availability: "How much time will you have this week to work on this issue?"
4. ETA: "When do you expect this issue to be completed?"
5. 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, September 19, 2023 at 12:06 AM PST.}

[MattChau01]

Progress: I will be working on a pull request review for issue #5558 and #5565 and picked up a small issue #4961.

Blockers: No blockers as of yet.

Availability: I will be available in the evenings this weekend.

ETA: Looking to complete my pull request reviews by tonight, Friday and completing my small issue by end of Sunday.

[MattChau01]

Progress: I've successfully closed out my small issue #4961 and will be reviewing a pull request

Blockers: None

Availability: Will be available for reach in the evenings on weekday and most of the day on the weekends

ETA: Looking to complete code review by end of day Friday.

[MattChau01]

Progress: Will be working on reviewing pull requests: #5661 and #5664
Blockers: None
Availability: I can be reached in the evenings
ETA: Looking to complete items by end of Sunday

[MattChau01]

Progress: Will be looking through the latest pull requests to do some code reviews
Blockers: None
Availability: Can be reached anytime through the days via Slack

[github-actions]

@MattChau01

Please add update using the below template (even if you have a pull request). Afterwards, remove the 'To Update !' label and add the 'Status: Updated' label.

1. Progress: "What is the current status of your project? What have you completed and what is left to do?"
2. Blockers: "Difficulties or errors encountered."
3. Availability: "How much time will you have this week to work on this issue?"
4. ETA: "When do you expect this issue to be completed?"
5. 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, October 17, 2023 at 12:06 AM PST.}

[MattChau01]

Progress: Will be working on reviewing pull requests: 5731
Blockers: None
Availability: I can be reached in the evenings
ETA: Looking to complete items by end of today

[MattChau01]

Progress: will be reviewing PR 5785
Blockers: none
Availability: evenings
ETA: Looking to complete by end of day Thursday

[MattChau01]

Progress: will be reviewing PR 5788
Blockers: none
Availability: evenings
ETA: Looking to complete by end of day Sunday

[github-actions]

@MattChau01

Please add update using the below template (even if you have a pull request). Afterwards, remove the 'To Update !' label and add the 'Status: Updated' label.

1. Progress: "What is the current status of your project? What have you completed and what is left to do?"
2. Blockers: "Difficulties or errors encountered."
3. Availability: "How much time will you have this week to work on this issue?"
4. ETA: "When do you expect this issue to be completed?"
5. 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, October 31, 2023 at 12:06 AM PST.}