Triage Squad GitHubGitHubGitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ triage: Biweekly on Thursdays 07:00 UTC
Thank you so much for your interest in taking notes for the Training Team! This is one of the first and easiest ways to get started contributing; this can help you orient yourself to what we’re working currently working on, find the things you’d like to do that interest you the most, and keep the greater WordPress community in-the-know.
The Training Team hosts text-based weekly meetings in SlackSlackSlack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. in the #training channel. Attendees may comment on discussion items in real-time, or asynchronously.
Meeting agendas are published in GitHubGitHubGitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ and are assigned the Meeting Agenda label. These are generally published in collaboration with Team Reps by contributors who have experience contributing in the team.
Meeting recaps are published as posts on the Training Team blog and are assigned the meeting-recap tag. Recaps are published at the end of the week the meeting was conducted in, to incorporate the input provided by contributors after the meeting concluded.
When a contributor volunteers to post meeting recap notes, a Training Team admin should give them Author access on the site.
To do this, go to https://make.wordpress.org/training/wp-admin and login with your WordPress.org account. If you do not yet have access, please ask a Training Team Representative to grant you Author access by pinging the @tt-admins group in the #training channel in Slack
Example Slack message: Hi @tt-admins. I am the note taker for this week's meeting, but I don't have access to the Team Blog. Please grant me Author access to https://make.wordpress.org/training/. Thanks!
Once logged in, select Post > Add New from the left sidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme..
Please publish meeting notes by the end of the week that the meeting occurred.
Select the Recap for Training Team Meeting Pattern to use the training team’s easy-to-follow template
Please do not paste Google Docs and Google Spreadsheet links in the notes. Instead, link to the Slack message that mentions the document.
Once inside the newly created post type /recap and select Recap for Training Team Meeting pattern
Replace the URLURLA specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org after “Meeting Agenda” with the link of the meeting agenda GitHub issue from this list of GitHub issues.
Replace the URL after “Slack Log” with a link of the first Slack message of that week’s meeting.
Add a list of attendees. We always ask “Who is joining us?” in each meeting. Make sure to find each attendee’s WordPress.orgWordPress.orgThe community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/ usernames in this thread. Do not use their Slack usernames.
Add a list of newcomers. If a newcomer has a WordPress.org username, prefer to list that so that the published P2P2P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/. links to their correct profile page. If you find someone hasn’t created a WordPress.org profile yet, then it’s okay to mention their Slack username instead.
Don’t know what the WordPress.org username is for someone in Slack? No problem! Follow these three steps to find the WordPress.org username for anyone in the Make WordPress Slack:
Open a person’s Slack profile. From the three-dot menu, select Copy member ID.
That will then redirect to that person’s WordPress.org profile page, so you can find their username in the URL.
Summarize the points discussed in the meeting. The idea is to condense the information to the most important parts so that it’s easy to read and get the most important points quickly.
Add Categories and Tags. Make sure to select categories of whatever was spoken about, and assign respective tags:
IMPORTANT: If you use any images, make sure to add alt tags!
If there are any images used in the recap notes, make sure to include an ‘alt’ tag in the image settings to describe the image. This ensures that anyone who uses a screen reader or has a slow internet connection can access the information that image contains. See the example below:
Ask a team administrator to confirm and publish the notes for you. Save your notes, and pingPingThe act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.”@tt-admins in the #training Slack channel with a link to your post draft. Once confirmed, they’ll be able to publish the post for you.
Example Slack message: Hi @tt-admins. I am the note taker for this week's meeting. Please confirm my draft below and publish this once it is ready. Thanks! https://make.wordpress.org/training/wp-admin/post.php?post=12345&action=edit.
Note to team admins: Please link the published recap post as a comment in the agenda’s GitHub issue and close the issue.
Update the name of the issue to include the date of the meeting.
For example, Meeting Agenda June 27, 2023.
In the body of the issue, update each section with the relevant information
Confirm the time of the meeting is accurate, and MEETING_HOST with your GitHub user name.
Intro/Welcome: Leave this as-is in the agenda. But before the meeting starts, take note of the Slack Usernames of everyone who joined since the last meeting, so that you can mention them during the meeting.
News: Any relevant new information for the Training team.
News items are mentioned for two weeks, in case people don’t aren’t able to catch one meeting.
Start by copying across news items from the the previous week’s meeting agenda. Then, remove items that were also mentioned in the meeting agenda from two weeks ago. Finally, add any new items that were brought to the team’s attention either in a post or Slack conversation that were published in the last week.
Updates from last week's Triage Squad session can be pulled from the #meta-learn Slack channel. Feel free to ping a Triage Squad member if you cannot find a recap of that week’s triage session.
Open requests for review: Open GitHub issues ready for review and copy-paste the link to issues listed there, by their content type.
Projects update: List current projects, the username of the primary point of contact for the project, and their most recent updates.
You can find a list of projects on the Current Focus Areas post pinned to the top of the team blog. (If you see there is outdated information on this post, please notify a team repTeam RepA Team Rep is a person who represents the Make WordPress team to the rest of the project, make sure issues are raised and addressed as needed, and coordinates cross-team efforts..)
The primary point of contact for a project is generally the author of the project post.
Open discussions: This is where the meeting is open for any attendee to bring up a topic they’d like to discuss.
Submit the new GitHub issue and ask a Training Team Reps for a review.
Do not copy and paste whole Slack conversations. The meeting recap is a summary of the meeting, not a duplication of Slack.
Please make sure you use WordPress.org IDs in the recap for attendees, acknowledgements, and notes. Only use Slack usernames for announcing new team members. All attendees are asked to provide their WordPress.org ID’s at the beginning of the meeting. If in doubt, you can ask the attendee.
If you have any questions, don’t hesitate to ask in the #training channel. We are happy to help, and your questions make our entire team better!