Dev-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: Thursdays 07:00 UTC
The Training Team is excited to announce a new role to the Faculty Program – Translation Coordinators. If you have experience translating content for the Training Team and are excited about helping even more people get involved, then Apply to Join today!
Introducing Translation Coordinators – a new Faculty role
The Faculty Program is a team of dedicated volunteers who work to achieve the goals of the Training Team. The new Translation Coordinator role aims to add to the team those who are experienced with translating content for Learn.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/, have a strong connection with their local community, and are excited to help others join the team’s translation efforts.
You can read more about the Translation Coordinator role in the handbook page below. If this is something you are interested in, come apply to join today!
While applications for the Translation Coordinators role are open to those who have a strong record of being leaders in their communities, the Content Translators role is available for anyone to join at any time!
Content Translators translate content that has been published on Learn.WordPress.org into their own locale. If you’re interested in joining the Training Team as a Content Translator, come walk through the Training Team’s onboarding program.
I’m pleased to announce that the two new 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/ project boards discussed in this proposal have been created. Read on to see what’s new.
A new handbook page has been created, detailing how this project board works, and listing steps SMEs can take to vet topic ideas. We invite all SMEs to read through Vetting Topic Ideas, and in particular, the section “Vetting topic ideas”.
While the new project board doesn’t introduce major changes to content localization processes, it should make identifying and tracking localization issues much easier. We invite all Faculty Admin to read through the new handbook page:
Summary: This post outlines the details of creating a new onboarding experience for those who join the Training Team. The need for a more effective onboarding experience was raised in recent sprint retrospectives (June & July Sprint, August Sprint), and discussed in [Discussion] Reimagining the Training Team contributor roles. This proposal brings clarity to documentation and in-person guidance used in onboarding, by focusing on four areas of expertise within the team.
Next Steps: The plan is to start building out the proposed onboarding flows from mid-November. Let’s discuss ideas and specifics in the comment section below, and come up with a concrete plan by November 18th.
Summary of Previous Discussions
The Training Team has identified that the current onboarding process for new contributors in the Training Team is confusing and in need of improvement. Points of improvement raised in recent discussions include:
Easing the onboarding process for new contributors.
Assign a point of contact for new contributors to reach out to in each role.
Prepare onboarding videos/lesson plans for each role.
Continue building the handbook so contributors have more precise guidance.
Clear guidelines for new joiners, especially for basic and Intermediate-level contributors.
The team also raised points we’d want to keep in mind as we build out a new onboarding experience:
Opportunities should remain for contributors who only have 30-60 minutes to contribute to get involved, without having to go through a lengthy onboarding process.
Documentation regarding who is in each role would be desirable.
Proposal: Four onboarding paths
Here is a proposal that reimagines the onboarding process to the Training Team, while also incorporating all the points listed above.
Step 1: First contact
When someone joins the #training channel, or submits a contact form, Welcome Wranglers send a personal message to the new contributor. In this message, we would include the question, “Of these 4, which are you most interested in?”
Vetting content ideas and being a sounding board to people creating new content
Focusing on the administration that keeps the Training Team running smoothly
Notice, the answer to this question will tell us which of the 4 areas of expertise in the team the contributor is interested in:
Subject Matter Expert
Step 2: Onboarding pages
Depending on their answer, folks are navigated to one of four onboarding pages in the Training Team handbook. Each page has a similar format, but includes information specific to that area of expertise.
Page title: “area_of_expertise Onboarding”
Welcome Video with script
A quick overview of how this area of expertise functions in the content creation flow within the Training Team.
List of faculty members with this expertise
Introduce the faculty members as the new contributor’s mentors. Mention how to use the at-mention feature 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/. to reach all these folks at once in the #training channel.
Walkthrough of how to complete a first contribution
Ideally, this first contribution should be something people can complete in 30-60 minutes.
This would be a link to another page in the handbook titled “A first contribution as an area_of_expertise“. The page would include short videos for each process, accompanied by text explanations.
It would be nice if each page had a “Thank you video” at the end folks would watch where they see the face of a real human thanking them for their contribution.
Invitation to have the contributor add themselves to a list of contributors available to continue contributing in that area of expertise
By walking a contributor through adding themselves to a list, we give them a sense of empowerment, and a touch of responsibility. They’d be free to come back and remove themselves from the list whenever they become unavailable to contribute.
A list of roles in this expertise for the contributor to explore further
This would be a link to another page in the handbook titled “area_of_expertise roles”. It would Include video walkthroughs and step-by-step instructions for all roles currently listed in the handbook that pertain to that particular area of expertise.
Invitation to join team meetings
Step 3: Continued mentorship
This proposal stops here for the moment. But I can see the team building out additional processes for those who want to continue growing to move up the contributor ladder and/or become Faculty Members.
What about casual contributors who only have 30-60 minutes?
In the above proposal, we would have created a page for each expertise walking folks through a first contribution in that expertise. These would be ideal pages to share with folks who want to make a quick contribution. Making one handbook page that links to those 4 pages would make sharing easier.
Page title: “Quick contributions you can make now!”
Welcome video with script
In this video, the speaker will still ask the same question as step 1 above. This will help the contributor decide which of the 4 links below they should follow.
We could also use a similar survey to https://orientation.wp-europe.org/ to pair a contributor up with an area of expertise.
List of four “first contribution” pages
Pages are reused from the flow above, and conclude with a “Thank you video”.
Invitation to work through the official onboarding flow above to contribute even more!
How would we make sure the list of contributors is accurate?
Administrators could keep an eye on the list and send a “Hi!” message to anyone who adds themselves, just to make sure the contributor is aware of the purpose of the list. Then, every 6 months or so, administrators could touch base with all who have added their names to confirm they’re still interested in contributing for another 6 months.
How are we ensuring the contributor ladder is applied to this idea?
The current contributor ladder model is a great start, but will need to be updated as this onboarding flow is created and implemented. For example, there are currently no Content Creator roles in the very first rung of the ladder. However, there should be something a new volunteer with a passion for creating content should be able to do without having to experience other areas of expertise first. We would work out which of the Content Creator related roles could be moved down the ladder and introduced as a first contribution to those with a passion to create content.
Could we get, say, Matt or Josepha to record the Thank You videos? 😃
That is definitely something we could consider. Another idea is to record multiple Thank You videos from multiple contributors, and then show a random video each time the page is loaded.
Next Steps: The plan is to start building out the proposed onboarding flows from mid-November. Please leave any other ideas, questions or comments you have below. We will come up with a concrete plan by November 18th.
Erica, Angela, and Hari gave us a look at how workshops have been vetted so far. This is shifting to a Training Team role, so learning how this has been handled was fantastic. If you missed the meeting, catch the replay above.
Below you will find many links mentioned during the meeting.
The Training Team proposes the following criteria for their profile badges:
Team On-boarding (Required): You have joined the #training channel 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/., been added to the TrelloTrelloProject management system using the concepts of boards and cards to organize tasks in a sane way. This is what the make.wordpress.com/marketing team uses for example: https://trello.com/b/8UGHVBu8/wp-marketing. board and the 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/ organization. You have read through the Getting Started information (https://make.wordpress.org/training/handbook/getting-started/) and are familiar with the lesson plan template, the team’s workflow, and the teams tools (GitHub, ZenHub, and Trello). You understand the various channels of communication and know when and how they should be used.
Writing – You have developed an approved lesson plan from scratch or completely rewritten one that was out of date. Your efforts have moved a lesson plan from the “Drafts in Progress” stage to the “Instructional Review” stage in Trello.
Copyediting/Reviewing – You have contributed five (5) pull requests in GitHub. Or you have successfully moved a lesson plan from the “Copyediting in Progress” stage to the “Style Guide Review” stage OR from the “Style Guide Review” stage to the “Ready for Final Review” stage in Trello.
Testing – You have completed a testing feedback form after using a lesson plan in an event and have created GitHub issues for any suggested changes.
Auditing – You have audited three (3) lesson plans or surveyed the team’s GitHub reposreposThe Training Team uses GitHub for working copies of lesson plans. You can find them at https://github.com/wptrainingteam. and created GitHub issues for any needed changes.
Connecting – You have made three (3) workshop recommendations by combining existing lesson plans and submitting your ideas through the https://learn.wordpress.org/ site (when ready).
Other – the team may choose to award the badge for other contributions at the team’s discretion.
Training Team: You have admin rights on GitHub, Trello, ZenHub, and/or the https://make.wordpress.org/training/ site. You assist with final reviews of lesson plans. You regularly contribute to meetings or the maintenance and management of the team. You have been involved within the past twelve months.
Awarding of profile badges: There will be a monthly review of contributions, and badges will be awarded at that time. A list of the new profile badges awarded will then be posted on the https://make.wordpress.org/training/ site. If you feel that you have earned the badge but were not listed, please leave a comment on that month’s blog post and include your GitHub username and your WordPress.org username.
In last week’s team meeting, I brought up a few common styling issues that copy editors have noticed while editing lesson plans. As promised, I’m expanding that list here. For more details on many of the items referenced in this list, please refer to the style guide.
Issues we’ve seen frequently include:
Lots of different kinds of quiz formatting. The quiz formatting is outlined in the style guide, so take a look at that when writing out quiz questions.
Random horizontal rules. We don’t need these to separate major sections (e.g. “Teacher Notes” from the “Hands-On Walkthrough”), but watch out for them because they are included in some plan drafts that were created a long time ago. Please DO use horizontal rules if they make sense to separate sections of content within the hands-on walkthrough section.
Capitalizing WordPress specific terms and phrases like “Posts,” for example. Unless a word is a proper noun in general, we don’t need to capitalize it.
Absence of punctuation. Sentences should always end with the appropriate punctuation!
Misspelling of WordPress. WordPress has a capital “P” and should never ever be spelled with a lower case “p.”
Inclusion of random notes. Once you’re done with your lesson plan, make sure you’ve deleted any notes you wrote to yourself as you were working!
Absent quizzes. Be sure to include 1-3 quiz questions for your lesson plan. If you’re not sure what the questions should be, that’s ok. In this case, flag that the quizzes are absent before sending the plan to copyediting.
Absent exercises. Be sure to include an exercise that would take approximately 5-10 minutes to accomplish. As with quizzes, if you’re not sure what the exercise should be, flag that an exercise is absent before sending the plan to copyediting.
We’ll be using this list to create a checklist for lesson plan authors to go through before submitting their plans for copyediting and for copy editors to use while editing, so please list any additional items you’ve noticed in the comments!
@jillbinder‘s speaker lesson plans are nearly done. Once they are done, this will be our first complete “workshop” series.
Expect testing feedback on the lesson plan “The LoopLoopThe Loop is PHP code used by WordPress to display posts. Using The Loop, WordPress processes each post to be displayed on the current page, and formats it according to how it matches specified criteria within The Loop tags. Any HTML or PHP code in the Loop will be processed on each post. https://codex.wordpress.org/The_Loop.” from @torlowski. There were some challenges while testing this recently, causing a delay in the meetupMeetupAll local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. and change in testing plans. They will try again in January.
Quarterly lesson plan audit
User Lessons – Any plans that are on this list that I don’t hear back from anyone on by next Tuesday will be opened up for others to work on. managing menus @wpnzach what can you do with WordPress @meaganhanes
maintain 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. navigation for the lesson plans
all documentation and all lesson plans stored in one content type
can remediate some of the content type sameness through custom menus, but then URLURLA specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org structures may not be consistent
@courane01 has gone through all posts on our team site to organize tags and categories. Descriptions of each tag and categoryCategoryThe 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. will be documented in the upcoming team handbook.
@linnifred would like a “Get Started” category as well.
WordCampWordCampWordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. NYC Contributor Day – how would it be useful for volunteers to contribute?
Feedback provided on “Anatomy of a Lesson Plan” via Pittsburgh WP MeetupMeetupAll local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area.
Update on slide decks from tested plans
Upcoming blog post with a list of tested plans that we’re looking to collect slides from, hopefully in the next week
Documentation on current WordPress releases can be found in the Codex (see Current Version of WordPress at https://codex.wordpress.org/WordPress_Versions) and on the Blog in the “Releases” categoryCategoryThe 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging..
One person to scan through the point releases and make sure nothing beyond security stuff is in them that would impact the plans. It is identifying “if a component of WordPress is significantly changed in an update of the software itself” and noting what that change is.
Run a keyword search to flag ALL lessons that mention that component.
Time Zones – Our team meetings will continue to be 17:00UTC when daylight savings time happens in the US and Europe and anywhere else. Our team site now displays the next meeting time in the 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.widgetWidgetA WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user. in a way that is now localized to the time zone you are in. YAY!
Slides – We are still working toward what needs to be done before WCUS to submit our official request for slides, and what/how they are created, etc. Please comment on our P2 post!We had a little impromptu discussion on slides and what kinds of comments we’re looking for to propel our conversation forward at WCUS. We talked a little about the PDF option specifically and had the following questions/thoughts:
Is there a workflow that we could use that would result in PDF only slides that would be able to be created by and edited by anyone, regardless of whether or not they have licenses for proprietary software?
One of the concerns with PDF is that it can’t be edited. Perhaps if we go with a slide pluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party (that makes the slides HTMLHTMLHTML is an acronym for Hyper Text Markup Language. It is a markup language that is used in the development of web pages and websites. of some sort) is that it has an “export as PDF” option. That way if something is updated in the lesson plan, then the PDF will be updated when the presenter exports one as needed.
A possible existing plugin to explore in terms of capabilities: https://wordpress.org/plugins/html5-slideshow-presentations/
The customizerCustomizerTool built into WordPress core that hooks into most modern themes. You can use it to preview and modify many of your site’s appearance settings. user plan is up for grabs if anyone would like to work on it.
The Pittsburgh meetupMeetupAll local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. is testing the Anatomy of a Theme plan tomorrow
We received feedback from the Intro to CSSCSSCSS is an acronym for cascading style sheets. This is what controls the design or look and feel of a site. plan that was also tested at the Pittsburgh meetup
@bethsoderberg will make a list of plans that have been tested and will post something to the P2P2P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/. requesting all existing slide decks from people who have tested plans. We’ll use what we gather to inform our slides conversation.
We are not easily able to find our stuff or know what stuff there is to find. – @juliekuehl
Our main navigation menuNavigation MenuA theme feature introduced with Version 3.0. WordPress includes an easy to use mechanism for giving various control options to get users to click from one place to another on a site. contains some of this stuff… but doesn’t include what we’ve started to come up with for other things… like our new procedure for audits and contributor days. – @courtneyengle
What needs do we have in terms of organizing documents and collateral for the training team?
We need to be able to find our stuff efficiently. – @juliekuehl
If EVERYONE else is using the [handbook to store documentation], we should too. – @mikemueller
We need to dig back into the archives and also consider what belongs in the handbook, and then think about where to store the pages that contain lesson plans. – @courtneyengle
We started talking about how to move forward with reviewing plans to make everything up to date per our larger conversation on ensuring accurate lesson plans. We ran out of time and will loopLoopThe Loop is PHP code used by WordPress to display posts. Using The Loop, WordPress processes each post to be displayed on the current page, and formats it according to how it matches specified criteria within The Loop tags. Any HTML or PHP code in the Loop will be processed on each post. https://codex.wordpress.org/The_Loop. back to this next week.