October 2021 Team Sprint

The Training team is using the Sprint method to determine what we are working on and to determine our timeframe for delivery.

What is a Sprint?

Sprints are fixed length events of one month or less to create consistency. A new Sprint starts immediately after the conclusion of the previous Sprint.

https://www.scrum.org/resources/what-is-a-sprint-in-scrum

As a team, we follow the Sprint approach loosely. While some of us are agency-sponsored contributors, others are self-sponsored. We recognize that volunteers may choose to work on what interests them, while agency-sponsored individuals may work through the priorities assigned to them. We allow room for both approaches in our Sprint planning. What is most important is that we work in the open and share what we are working on here.

This post may be updated throughout the month to reflect work that has been completed. Append any explanations as comments below.

Sprint Goals

Learn Maintenance

Learn Content

We are currently using TrelloTrello Project 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. to manage and keep track of the status of each piece of content on Learn (lesson plans, video workshops and courses). Every piece of content has its own Trello card. The Trello lists represent our Development Workflow, each list contains a card that explains how to use that list.

Lesson Plan, Workshop Video Workshop and Course Ideas

The cards in this list are in need of a contributor to:

  • Finalize description
  • Set objectives (goals)
  • Research and add links to support and developer docs
  • Identify marketing communications
  • Carry out an SEO review.
  • Review related material on Learn

If that’s you, add yourself as a Member on the card and as the Current Owner. If you need any help, please ask in the SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. #training channel.

  1. Lesson Plans
    1. Using Global Styles & Settings
    2. How to use the Query Loop
    3. Intro to the Block Editor
    4. Frequently Used Blocks
    5. Form Email Deliverability (SMTP Issues) @magicroundabout
  2. Courses
    1. Advanced PluginPlugin A 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 Development @webtechpooja
    2. MeetupMeetup All 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. Organizers @peteringersoll
    3. An intro to WP-CLI @magicroundabout

Next Up – You Can Help!

The cards in this list are in need of a contributor to draft them up. If that’s you, add yourself as a Member on the card and as the Current Owner. Then move the card to the Drafts in Progress list. If you need any help, please ask in the Slack #training channel.

  1. Lesson Plans
    1. Site Backup
    2. Migrate, Copy, or Clone a Site @arasae The lesson plan already exists so a video workshop will be created insntead.
    3. Introduction to Gutenberg @peteringersoll

Drafts in Progress

A team member has taken ownership of the cards in this list and is currently working on it. If you have started working on a card and are unable to take it to completion, please let the team know in the Slack #training channel.

  1. Lesson Plans
    1. How to create a blog post in WordPress 5.x @geheren
    2. How to Configure WordPress Installation for Contributor and Developer Testing @woodnet @caseymilne @paaljaochim This will need to be organised to follow our normal lesson plan and workshop formats. It is also in need of Windoes user to help with the testing enviroment.
    3. Testing a Trac ticket or GitHub PR @woodnet @caseymilne @paaljaochim
  2. Courses
    1. How to Contribute to the Training Team @courane01 begin creating
    2. Theme Course Development @courane01 will continue scoping into October
    3. Full Site Editing @daisyo

Instructional Review

The cards in this list have been drafted but are in need of a team member to quality check them before going to copyediting:

  • Does the description fairly describe what is covered?
  • Have the objectives been written using Bloom’s Taxonomy?
  • Have the objectives been met?
  • Does the assessment (quiz) match the objectives?
  • Are the pre-requisite skills really necessary?
  • Will “students” be able to perform the exercises with what has been covered?
  • Does the content build from or duplicate material in other lesson plans, video workshops or courses?

If that’s you, add yourself as a Member on the card and as the Current Owner. When you finished, move the card to the Ready for Copyediting list. If you have started working on a card and are unable to take it to completion, please let the team know in the Slack #training channel.

  1. Lesson Plans
    1. Using a browser inspector@woodnet (revising screenshots)

Ready for Copyediting

The cards in this list are ready to be reviewed for typos, grammar, understandability, completeness, and general style. If that’s you, add yourself as a Member on the card and as the Current Owner. Then move the card to the Copyediting in Progress list. If you need any help, please ask in the Slack #training channel.

Copyediting in Progress

The cards in this list are undergoing active work on copyediting. A team member has taken ownership and is currently working on it. Check:

  • Spelling errors (if applicable)
  • Grammar errors (if applicable)
  • Readability (use a tool such as https://www.perrymarshall.com/grade/, we should stay under 9th grade, but technical stuff may differ) (if applicable)

If that’s you, add yourself as a Member on the card and as the Current Owner. When you finished, move the card to the Style Guide Review list. If you have started working on a card and are unable to take it to completion, please let the team know in the Slack #training channel.

Style Guide Review

These are cards that need to be checked to make sure they adhere to the team’s style guide. If that’s you, add yourself as a Member on the card and as the Current Owner. When you finished, move the card to the Ready for Final Review list. If you have started working on a card and are unable to take it to completion, please let the team know in the Slack #training channel.

Ready for Final Review

The cards in this list have been through copyediting, instructional review, and testing and are nearly ready for official publication.

The Training Team admins will review the cards for:

  1. Adherence to the current template
  2. Adherence to the current style guide
  3. Quality and completeness of information
  4. Any technical formatting details needing to be changed in order for the content to be published
  5. Slide review or creation
  6. Anything else needing attention before publication

Cards move out of this list (and to the Lesson Plans Ready for Publication list) when they have been approved by the team admins.

  1. Lesson Plans
  2. Courses
    1. Unleasing the Power of WordPress
    2. Publishing with WordPress
    3. Getting Started with WordPress

Audit and Expand Content on Learn

  1. Turning existing lesson plans on Learn into workshops:
    1. Customizer Taglines @west7
    2. Best Practices When Capturing Images @rkohilakis
    3. Migrate, Copy, or Clone a Site @arasae
    4. Managing Widgets @west7
    5. Admin Settings @rkohilakis
  2. Review unpublished brand specific content against newly published brand guidelines
  3. Preparing Learn content for future WordPress updates @tantienhime

Published

The following video workshops have been created from their corresponding lesson plan.

  1. Managing Spam on Your Website @west7
  2. Best Practices for Capturing Images @rkohilakis
  3. Customer Taglines @rkohilakis
  4. How to Create a Post or Page with the WordPress Block Editor @west7

Learn Functionality

These are our high priority items. If you are interested in helping out, please let us know in the #meta-learn Slack channel.

  1. Style a print-friendly style sheet (transcripts and lesson plans)
  2. Use a blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. layout in a page to create much of the lesson plan page organization https://github.com/WordPress/learn/issues/153 (pending UXUX UX is an acronym for User Experience - the way the user uses the UI. Think ‘what they are doing’ and less about how they do it. audit review)
  3. New ‘Other Contributors’ field for workshops
  4. Add Review Notes panel to workshop post type
  5. Customer user roles for Learn WordPress
  6. Fix quiz button styling to match other buttons
  7. Automatically recognize contributions on Profiles
  8. Make clear that quizzes that come up in search results are quizzes
  9. Add details about discussion groups in workshop pages
  10. Google Slides block for Lesson Plans The team is carrying out an audit of the Slides Plugin to ascertain the level of maintenance required and amount of work needed to fix the bug @binarygary @alexstine @danilong
  11. Add license information for the contents
  12. Disable the News XML sitemap
  13. Integrate Meetings calendar plugin
  14. Integrate speaker feedback tool
  15. Learner recognition on WordPress.org profile @iandunn
  16. Custom user roles for Learn WordPress @coreymckrill

Visit GitHub for a complete list of open issues.

Training Team

  1. Audit Learn Functionalitly Trello board
  2. Deputy program
  3. Update Learn Handbook
  4. Conduct a retrospective on the previous sprint.

Upcoming Meetings

You are welcome to join the team at any time! If you are new to the Training Team, please introduce yourself in the #training channel before the meeting (or anytime!) and feel free to join us in the meeting and participate as you are able.


Training Team Mission

The WordPress training team helps people learn to use, extend, and contribute to WordPress through synchronous and asynchronous learning as well as downloadable lesson plans for instructors to use in live environments, via learn.wordpress.org.

Getting Involved

Everyone is welcome and encouraged to join in, comment on posts, and participate in meetings and on projects. Here’s what you need to know to get started.

Team Links

  1. Getting Involved:- https://make.wordpress.org/training/handbook/getting-started/
  2. About The Team:- https://make.wordpress.org/training/handbook/about/ 
  3. Our Team Blog:- https://make.wordpress.org/training/ 
  4. Our Content Roadmap:- https://trello.com/b/BsfzszRM/wordpress-training-team-lesson-plan-development 
  5. What We Are Currently Working On This Month:- https://make.wordpress.org/training/category/sprint/
  6. Learn WordPress Roadmap:- https://trello.com/b/rK1tztAA/learn-wordpress 
  7. Learn WordPress Issues Log:- https://github.com/WordPress/learn
  8. Our Lesson Plans:- https://learn.wordpress.org/lesson-plans/
  9. Our YouTube Channel:- https://www.youtube.com/channel/UCnxqNA0WORZXWurEP6cNV6w 
  10. Learn Website:- https://learn.wordpress.org/

#learn-wordpress, #learnwp, #meta-learn, #training, #training-team

Learn WordPress Needs Assessment Results

In order to obtain an expert third-party view of what Learn WordPress needs in order to succeed, a leading digital learning consultant (AllenComm) was contracted to perform a full needs assessment of the platform. This needs assessment was funded by Automattic, and the research was entirely neutral and based on observations made by AllenComm themselves.

After a few months of this ongoing assessment, the final results have been delivered so here they are in their entirety.

First up, here’s a PDF of the full presentation of their findings:

Along with that, here are the results of the public user survey that was included in their research:

And, finally, they also created these interactive mockups of how Learn WordPress could be improved based on their findings.


Since there’s a lot to go through in all of that, here’s the executive summary of the findings from the assessment:

1. Make it minimal and meaningful

  • Offer assessments to determine level of expertise and user group.
  • Make the site easy to navigate with intuitive searching solutions with auto complete options for commonly searched terms.
  • Include filters that can be easily accessed with meaningful content.
  • Provide quick access to topics and solutions that apply to them. Because most use this for work obligations, they’ll need quick solutions and quick access.

2. Make it concise and customised

  • Provide a revolving carousel of new options for learning to ensure the new content gets cycled through and older content is flagged as possibly outdated.
  • Facilitate easy, simple options for them to take ownership to invest their own content based on the needs of the community.
  • Create badging or indicators that coincide with their level of expertise based on completion and contributions.

3. Make it iterative

  • Create flexible, current opportunities for the users to make the site their own based on their interests and level of expertise.
  • Apply dates to all materials so learners can determine if the content is applicable to current versions of their current processes.
  • Provide current, relevant supplementary materials for specific topics such as editors and plug-in functions. (PDF)

4. Make it interactive

  • Include training activities that encourage the users to apply or think through the application of new processes or solutions.
  • Don’t test them on knowledge, but instead outline various use cases for the lessons and materials.
  • Provide pre-recorded sessions and a way to ask questions of the presenter.

5. Make it interpersonal

  • Provide access to a collaboration of real people in real time so they can garner specific support when and where they need it.
  • Continue to provide instructional videos of real people who may share some struggles they’ve also had and how they’ve solved it.
  • Provide a feedback loopLoop The 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. where they can offer suggestions and receive responses.

There are some very exciting ideas in there and there’s a lot that I’m looking forward to exploring further! It is important to note, however, that none of this is prescriptive – just because the report suggests we do something, doesn’t mean we need to do it. Our task from here is to use this to figure out just what we need and what we can implement from all of this.

Please discuss in the comments of this post and leave any thoughts or feedback you might have!

A Dedicated Volunteer Program for the Training Team

For some years now, the Community Team has been running the highly successful Community Deputy Program:

Community Deputies are a team of people all over the world who review WordCampWordCamp WordCamps 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. and MeetupMeetup All 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. applications, interview lead organizers, and generally keep things moving at WordCamp CentralWordCamp Central Website for all WordCamp activities globally. https://central.wordcamp.org includes a list of upcoming and past camp with links to each.. We make sure that new and returning organizers are not overworking themselves, still are following the code of conduct, and generally are making positive contributions to the open-source project. 

In short, Community Deputies are volunteers who contribute time to the Community Team to help keep things running smoothly. These responsibilities relate to meetups, WordCamps, WordPress Foundation events, conflict mediations, and anything else that falls under the purview of the Community Team. It is successful for a number of reasons – primarily because it ensures the workload of the team is spread across more people, and that it serves to decentralise the management of the Community Team programs.

With that in mind, I’d like to propose we introduce a similar program for the Training Team.

Introducing…The Faculty Program

In education, the term “faculty” refers to the teaching and research staff related to a particular field of study at an institution. This makes it an appropriate name for a program of this kind within the WordPress Training Team.

I envision the Faculty Program as a group of people from all over the world who volunteer their time to pursue the objectives of the Training Team. It would function in much the same way as the Community Deputy program, so it would:

  • Be open to anyone to volunteer
  • Have relevant, but not overly stringent, requirements for acceptance
  • Have a defined list of available tasks
  • Include training on how to perform the required tasks

Here is a non-exhaustive list of the types of tasks that Faculty members would be able to perform – many of these aren’t new and are already performed by many wonderful volunteers:

  • Mentoring and guiding contributors
  • Creating lesson plans
  • Reviewing submitted lesson plans
  • Vetting workshop presenter applications
  • Generating video captions and transcripts
  • Collaborating on workshop scripts
  • Recording workshop videos
  • Auditing existing site content
  • Publishing submitted workshop videos
  • Vetting new Faculty member applications

The program would be managed by the Training Team in an open and transparent manner – Faculty members would be listed publicly, tasks would be as open as possible, training would be publicly available, and reporting would be done on the Training Team blog.

It’s important to note that anyone would still be able to contribute to the team even if they don’t join the Faculty program. Part of the benefit of having a formalised team is that it becomes easier to know who is doing the work and to set targets for getting things done.

What needs to be done to make this a reality?

In order to make this an effective program, it would need to be set up for success from the start. Here are some things that would need to happen before the team can begin reaching out to potential volunteers:

  • Define exactly what tasks are available for Faculty members (see the above list to start)
  • Write complete documentation on how to do all of the available tasks
  • Create training materials (hosted on Learn WordPress) for new volunteers joining the program
    • Training materials would be a combination of “how-to” guides (like the documentation) as well as covering the principles behind the work

Feedback

What do you think about this? Please provide feedback about this along the following lines:

  • Does the idea of a trained and dedicated volunteer team for Training Team tasks sound like a good idea to you?
  • Can you think of anything else that needs to be done in order to make this a reality?
  • Do you have nay other thoughts about how this program could work?

PROPOSAL: Ensuring high-quality video contributions to Learn WordPress

The Training Team is incredibly grateful to everyone who helped to launch Learn WordPress and has contributed valuable and solid content. Not least because Learn WordPress is going to be the first place that many people encounter in the WordPress project. Indeed, it may be the only part of the WordPress.orgWordPress.org The 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/ network that they ever engage with. This is due to the fact that many users will come looking for training on how to do something with WordPress and won’t have any interest in the community beyond that. If people come to Learn WordPress without any knowledge of how the WordPress community works as an open-source project, they will be expecting to find videos that match the quality they could find elsewhere.

A proposal

Learn WordPress content needs to be of high quality, but most people don’t have access to expensive recording equipment and it’s unrealistic to expect everyone to match the video quality of those who do. Production quality must not be a blocker for people contributing their skills and knowledge to the platform, so what can be done about it?

After thinking about this for a while, I have a proposal for how we can proceed that involves two areas of focus:

Distinguish between video types

The idea would be to distinguish between the highly produced videos and the community contributed ones in a similar way to how TED and TEDx talks are different from each other. This would mean there would be a separate taxonomyTaxonomy A taxonomy is a way to group things together. In WordPress, some common taxonomies are category, link, tag, or post format. https://codex.wordpress.org/Taxonomies#Default_Taxonomies. that clearly identifies which videos are produced with high-quality equipment and which ones are not. The visual distinction here would need to be discussed before we move forward with anything. My initial thinking is that there would be a section titled “Community Content” or similar that would feature the videos contributed by the community that are not of the production quality standards that are set. These production standards would need to be discussed and finalised before we implement anything here.

Collaborate on planning, but limit who can produce

The other area of focus to complement the separate video types would be to allow anyone to get involved in planning and scripting videos, but only allow approved people to actually record/produce the ones that are not included in the “Community Content” section. In practice, this could look something like this:

  1. Certain people are selected (through a public application process that anyone can submit themselves) to be approved as presenters & producers – this would have a few requirements along the lines of having access to high-quality recording equipment, being able to present well, etc. – this would need to be clearly defined and formalised with a vetting process for new applications. There would be a strong focus on building up a diverse set of voices for this group.
  2. Multiple people collaborate on outlining a video and writing a script for it – this would include anyone who would like to be involved.
  3. The finished outline and script is given to one of the approved presenters to record – this could be one of the people who wrote the script or it could be someone else.
  4. If the video is a screencast with a voiceover, we could even have a subject matter expert record the screencast and one of the approved presenters record the voiceover in order to ensure content can be written to cater to all skillsets.

The advantage of this is that anyone can get involved in creating content, even if they aren’t able (or don’t want to!) actually present/produce it, with the end result being that we have high-quality content produced to a high standard. All contributors would still be credited on the workshop video page regardless of their role in creating the video.

Feedback

Please provide feedback along the following lines:

  • Do you feel this proposal is a good way to ensure that Learn WordPress videos remain high-quality while also encouraging contributors to get involved?
  • Is there anything you would change about this proposal?
  • Do you have a different proposal to suggest?

This discussion on this post will be open until the end of the day on Wedensday, 6 October and then the comments will be summarised with a decision being made based on what is discussed.

#learn-wordpress, #proposal, #videos

PROPOSAL: Learner achievements on profiles

A planned feature for Learn is integration with WordPress.orgWordPress.org The 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/ profiles. There’s already an open issue on GitHub for recognising contributors with badges, so I’d like to nail down what kind of thing we would like to see regarding recognising learner achievements on profiles.

Here’s my proposal:

  • An activity stream entry whenever a learner completes a full course.
  • A persistent line showing the learner’s average grade on Learn WordPress – I envision this in the top right info blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. above the social links, but happy to be shown otherwise.
  • A new tab under ‘Activity’ called ‘Learning’ (or similar) that shows all of the courses they have completed along with their average grade for the course and what date they completed it on. This could also show individual lessons completed along with the relevant grades, or any other learning data that we have, but I think that courses will be the primary thing here.
  • A ‘Learner’ badge for everyone who has completed at least one course. This badge could use the same icon as the Training Team badge, but in a different colour.

One caveat is that we don’t have a lot of courses on the site at this stage, but that is changing as we develop new content so my hope is that we will have these rewards in place now and as content is created the rewards will flow naturally.

The goal here is twofold:

  1. To surface learning data as a way to make Learn WordPress more valuable to people, not to mention more prominent and visible
  2. To provide motivation for people to take courses

Is there anything else we could do on profiles to recognise learner achievements? Once we have agreement on this proposal it can be moved over to GitHubGitHub GitHub is a website that offers online implementation of git repositories that can 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/ for implementation.

September 2021 Team Sprint

The Training team is using the Sprint method to determine what we are working on and to determine our timeframe for delivery.

What is a Sprint?

Sprints are fixed length events of one month or less to create consistency. A new Sprint starts immediately after the conclusion of the previous Sprint.

https://www.scrum.org/resources/what-is-a-sprint-in-scrum

Sprint Goals

Learn Maintenance

  • Translation work sessions for subtitles and post content
  • Auditing all posts/lesson plans/workshops/courses for taxonomyTaxonomy A taxonomy is a way to group things together. In WordPress, some common taxonomies are category, link, tag, or post format. https://codex.wordpress.org/Taxonomies#Default_Taxonomies.
  • Creating slides for new plans

Learn Content

We are currently using TrelloTrello Project 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. to manage and keep track of the status of each piece of content on Learn (lesson plans, video workshops and courses). Every piece of content has its own Trello card. The Trello lists represent our Development Workflow, each list contains a card that explains how to use that list.

Lesson Plan, Video Workshop and Course Ideas

The cards in this list are in need of a contributor to:

  • Finalize description
  • Set objectives (goals)
  • Research and add links to support and developer docs
  • Identify marketing communications
  • Carry out an SEO review.
  • Review related material on Learn

If that’s you, add yourself as a Member on the card and as the Current Owner. If you need any help, please ask in the SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. #training channel.

  1. Lesson Plans
    1. Using Global Styles & Settings
    2. How to use the Query Loop
    3. Intro to the Block Editor
    4. Frequently Used Blocks

Next Up – You Can Help!

The cards in this list are in need of a contributor to draft them up. If that’s you, add yourself as a Member on the card and as the Current Owner. Then move the card to the Drafts in Progress list. If you need any help, please ask in the Slack #training channel.

  1. Lesson Plans
    1. Site Backup
    2. Migrate, Copy, or Clone a Site
    3. Introduction to Gutenberg

Drafts in Progress

A team member has taken ownership of the cards in this list and is currently working on it. If you have started working on a card and are unable to take it to completion, please let the team know in the Slack #training channel.

  1. Lesson Plans
    1. How to create a blog post in WordPress 5.x @geheren
    2. How to Configure WordPress Installation for Contributor and Developer Testing @woodnet @caseymilne @paaljaochim
    3. Testing a Trac ticket or GitHub PR @woodnet @caseymilne @paaljaochim
  2. Courses
    1. Introduction to WordPress @arasae
    2. How to Contribute to the Training Team @courane01 begin creating
    3. Theme Course Development @courane01 will continue scoping into October
    4. Full Site Editing @daisyo

Instructional Review

The cards in this list have been drafted but are in need of a team member to quality check them before going to copyediting:

  • Does the description fairly describe what is covered?
  • Have the objectives been written using Bloom’s Taxonomy?
  • Have the objectives been met?
  • Does the assessment (quiz) match the objectives?
  • Are the pre-requisite skills really necessary?
  • Will “students” be able to perform the exercises with what has been covered?
  • Does the content build from or duplicate material in other lesson plans, video workshops or courses?

If that’s you, add yourself as a Member on the card and as the Current Owner. When you finished, move the card to the Ready for Copyediting list. If you have started working on a card and are unable to take it to completion, please let the team know in the Slack #training channel.

  1. Lesson Plans
    1. Using a browser inspector@woodnet (revising screenshots)

Ready for Copyediting

The cards in this list are ready to be reviewed for typos, grammar, understandability, completeness, and general style. If that’s you, add yourself as a Member on the card and as the Current Owner. Then move the card to the Copyediting in Progress list. If you need any help, please ask in the Slack #training channel.

Copyediting in Progress

The cards in this list are undergoing active work on copyediting. A team member has taken ownership and is currently working on it. Check:

  • Spelling errors (if applicable)
  • Grammar errors (if applicable)
  • Readability (use a tool such as https://www.perrymarshall.com/grade/, we should stay under 9th grade, but technical stuff may differ) (if applicable)

If that’s you, add yourself as a Member on the card and as the Current Owner. When you finished, move the card to the Style Guide Review list. If you have started working on a card and are unable to take it to completion, please let the team know in the Slack #training channel.

Style Guide Review

These are cards that need to be checked to make sure they adhere to the team’s style guide. If that’s you, add yourself as a Member on the card and as the Current Owner. When you finished, move the card to the Ready for Final Review list. If you have started working on a card and are unable to take it to completion, please let the team know in the Slack #training channel.

Ready for Final Review

The Final Review list is for cards that have been through copyediting, instructional review, and testing and are nearly ready for official publication.

The Training Team admins will review the cards for:

  1. Adherence to the current template
  2. Adherence to the current style guide
  3. Quality and completeness of information
  4. Any technical formatting details needing to be changed in order for the content to be published
  5. Slide review or creation
  6. Anything else needing attention before publication

Cards move out of this list (and to the Lesson Plans Ready for Publication list) when they have been approved by the team admins.

Learn Functionality

  1. Style a print-friendly style sheet (transcripts and lesson plans)
  2. Use a blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. layout in a page to create much of the lesson plan page organization https://github.com/WordPress/learn/issues/153 (pending UXUX UX is an acronym for User Experience - the way the user uses the UI. Think ‘what they are doing’ and less about how they do it. audit review)

Training Team

  1. Audit Learn Functionalitly Trello board
  2. Deputy program
  3. Update Learn Handbook
  4. Conduct a retrospective on the previous sprint.

Upcoming Meetings

You are welcome to join the team at any time! If you are new to the Training Team, please introduce yourself in the #training channel before the meeting (or anytime!) and feel free to join us in the meeting and participate as you are able.


Training Team Mission

The WordPress training team helps people learn to use, extend, and contribute to WordPress through synchronous and asynchronous learning as well as downloadable lesson plans for instructors to use in live environments, via learn.wordpress.org.

Getting Involved

Everyone is welcome and encouraged to join in, comment on posts, and participate in meetings and on projects. Here’s what you need to know to get started.

Team Links

  1. Getting Involved:- https://make.wordpress.org/training/handbook/getting-started/
  2. About The Team:- https://make.wordpress.org/training/handbook/about/ 
  3. Our Team Blog:- https://make.wordpress.org/training/ 
  4. Our Content Roadmap:- https://trello.com/b/BsfzszRM/wordpress-training-team-lesson-plan-development 
  5. What We Are Currently Working On This Month:- https://make.wordpress.org/training/category/sprint/
  6. Learn WordPress Roadmap:- https://trello.com/b/rK1tztAA/learn-wordpress 
  7. Learn WordPress Issues Log:- https://github.com/WordPress/learn
  8. Our Lesson Plans:- https://learn.wordpress.org/lesson-plans/
  9. Our YouTube Channel:- https://www.youtube.com/channel/UCnxqNA0WORZXWurEP6cNV6w 
  10. Learn Website:- https://learn.wordpress.org/

#learn-wordpress, #learnwp, #meta-learn, #sprint, #training-team

Lesson Plans to Workshops: A Mini-Sprint

The training team has created some incredible work over the years, but none so prominent and detailed as the glorious archive of Lesson Plans.

They have actionable objectives.
They have clear steps.
They’re already detailed, vetted, and ready to roll for public use.

Ultimately, they are an excellent resource for potential video workshops!

This is a little late in the month to add to the sprint, but this is something that I’d love to see happen sooner rather than later, so I wanted to bring this idea into the public space!

While I’m wrapping up my first text-based course, there are a few lesson plans I’ve been spying that might make excellent supplementary video workshop material (such as @courane01‘s suggestion of using Demo Content) .

If this works well, we might consider how we will communicate who is working on turning a lesson plan into a workshop going forward (perhaps with a new column in the TrelloTrello Project 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?)

I’d like to see if we can more quickly produce a few workshops from existing lesson plans in a sort of mini-sprint in this in-between time as some of our new training team members are onboarding. Going forward, these will be included in our monthly sprints.

If interested this next week, please pick a lesson plan that you want to “claim” or are interested in creating a video workshop for in the comments.

We can also clarify this process once we’ve seen how it goes!

Should Learn WordPress contributors be GPL compliant?

In some cases – notably for anyone involved in a WordCampWordCamp WordCamps 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. in any official capacity – WordPress contributors are required to be GPLGPL GPL is an acronym for GNU Public License. It is the standard license WordPress uses for Open Source licensing https://wordpress.org/about/license/. The GPL is a ‘copyleft’ license https://www.gnu.org/licenses/copyleft.en.html. This means that derivative work can only be distributed under the same license terms. This is in distinction to permissive free software licenses, of which the BSD license and the MIT License are widely used examples. compliant. This means that any WordPress derivatives (i.e. themes, plugins, forks or distributions) that they distribute must be licensed under the GPL or a compatible licence. This isn’t the case for most areas of contribution, so let’s have a look at whether this should apply to contributors to learn WordPress.

The result of this conversation may seem obvious to some, but it’s good to discuss these things out in the open so that we have a documented record of where, why, and how these types of decisions have been made.

First, some precedents

In terms of contributions, Learn WordPress is an interesting blend of speaking and documenting depending on the area of contribution on the platform, so here are some precedents in both of those areas that we should be aware of:

Event speakers

Anyone who speaks at an official WordPress event (WordCamp, meetupMeetup All 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., etc.) is only allowed to speak if any WordPress derivatives they distribute are licensed with a GPL compatible licence. This has always been the case, and for good reason. Speakers (and organisers) are seen to represent WordPress to their local community, so they need to embody the same freedoms that the GPL affords WordPress users.

Documentation contributors

Anyone can contribute documentation to WordPress.orgWordPress.org The 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/the Docs team handbook doesn’t have any specific requirements listed and allows anyone to get involved. Since documentation writers aren’t specifically representing WordPress in the same way that event speakers, this is not an issue. Also, documentation contributors aren’t directly recognised for their specific contributions in the context of where it took place.

Core contributorsCore Contributors Core contributors are those who have worked on a release of WordPress, by creating the functions or finding and patching bugs. These contributions are done through Trac. https://core.trac.wordpress.org.

Since CoreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. is the oldest area of contribution in the project it’s also worth taking a look at how contributors can get involved and are recognised here. Anyone can contribute to WordPress core, regardless of their GPL compliance. All contributors receive props for their contribution directly on TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/., as well as being thanked in the announcement post on WordPress.org/news. Their name in the announcement post is linked to their WordPress.org profile.

OK, so what does that mean for Learn WordPress?

Lesson plans

Lesson plan contributors do not have any GPL requirements – this is much the same as for documentation in that anyone can contribute and specific contributors are not recognised directly on the lesson plans themselves. This seems right to me and is the best way to encourage as many people as possible to contribute.

Workshops

Currently, all workshop presenters are credited on the workshop page with their name, avatarAvatar An avatar is an image or illustration that specifically refers to a character that represents an online user. It’s usually a square box that appears next to the user’s name. and full bio pulled from their WordPress.org profile (example). Since workshop presenters are a public face of the project in much the same way that WordCamp speakers are, we have also been operating under the same requirements as WordCamp speakers when it comes to being GPL compatible. This also seems right to me and I am of the opinions that we should continue with this requirement.

It is possible, however, for people to contribute content to a video workshop without being the presenter on the screen. This raises some questions:

  1. Do we credit non-presenting content contributors in the same way as presenters?
  2. Should non-presenting contributors have the same GPL compatibility requirements as presenters?

Since one of the primary motivations behind the GPL requirement is to ensure that anyone publicly representing WordPress does so in a way that is faithful to the licence, it makes sense for presenters to have that same requirement, but I don’t think we can say the same for non-presenting contributors.

A proposal

After considering a few ways we could move forward here, my proposal is the following:

  • Anyone contributing text-based content to Learn WordPress does not have to fulfil any GPL compliance requirements, this would apply to lesson plans and any other area that is text/image based.
  • Workshop presenters (i.e. people who appear in videos whether on video or audio) must continue to be GPL compliant just like WordCamp speakers need to be – presenters will be vetted at the time of their workshop application just like WordCamp speakers are vetted.
  • Anyone contributing to workshops who is not appearing in the video itself (i.e. helped to create the outline, script, slides, editing, or any other area) does not need to be GPL compliant.
  • Workshop presenters will still be listed on the workshop page with their name, avatar and bio as they are now, while anyone contributing to the workshop in any other capacity would be listed in a blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. titled “Other contributors” with their name that is linked to their WordPress.org profile, just like in the core release announcements.

tl;dr: Anyone featuring in videos must be GPL compliant, but all other contributors need not be.

Feedback

Does this proposal sound like a good way to move forward? Please share any thoughts you have and we can discuss it all here.

This post will remain open for comments until the end of the day on Wednesday, 29 September. After that, comments will be summarised and we can formalise the guidelines based on this discussion

Proposal: Brand guidelines for Learn WordPress content

Shortly after Learn WordPress launched in late 2020, the decision was made to remove any content that mentioned any brand other than WordPress itself until guidelines could be established to indicate what kinds of brands could be mentioned, and how they can be presented. This was an understandable, and intentionally temporary, move to ensure that the platform remained balanced and unbiased towards any particular product or company.

As Learn WordPress is growing, this is a good time to revisit that decision and work on some guidelines that will help the team make wise decisions about brands being included in training content.

Goals

The purpose of creating brand guidelines here is threefold:

  • Learn WordPress needs to be home to high-quality learning materials that serve the needs of all WordPress users – from beginners to power users – without being home to commercial interests.
  • While the platform is not responsible for the success or failure of any particular business providing services to the WordPress community, it would be great if it could create a fertile environment for pluginPlugin A 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/theme developers, hosting providers and others to actualize their own goals and make a living while contributing to the community.
  • Guidelines need to consider the WordPress.orgWordPress.org The 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/ teams and volunteers involved. These contributors who make sure that everything runs smoothly deserve impactful tasks and appropriate credit. 

Proposal

Keeping the above mentioned goals in mind, here is a proposal for guidelines that can be implemented to remain in line with similar guidelines on other contributor teams. See the ‘References’ section below for more from other teams.

Brands can be included in Learn WordPress content if:

  • They are relevant to the piece of content in question.
  • They respect the WordPress trademark and don’t misuse it in any way.
  • They embrace the WordPress licence. Meaning that any WordPress derivatives (plugins, themes, or distributions) they distribute must be licenced under the General Public Licence (GPLGPL GPL is an acronym for GNU Public License. It is the standard license WordPress uses for Open Source licensing https://wordpress.org/about/license/. The GPL is a ‘copyleft’ license https://www.gnu.org/licenses/copyleft.en.html. This means that derivative work can only be distributed under the same license terms. This is in distinction to permissive free software licenses, of which the BSD license and the MIT License are widely used examples.).

Additionally, plugins and themes can only be included if there is a version of their product that is hosted in the WordPress.org Plugin/Theme Directory – this will not only ensure compliance with the licence and trademark guidelines, but it will ensure that any plugins/themes mentioned in the content will be freely and readily available for learners directly in their WordPress dashboard.

When brands are mentioned in training content:

  • At least 2-3 options of different brands that provide a similar product/service must be mentioned wherever possible and reasonable to do so. This is in order to keep the content aligned with the purpose of helping people learn how to use WordPress, rather than how to use a particular plugin/theme/service.
  • For practical reasons, in some cases it may be appropriate to have a workshop that is focused on a single plugin. In those instances, the content must be clear about the purpose (“How to use Plugin X”) and can only cover plugins/themes that are hosted in the WordPress.org Plugin/Theme Directory – no upsells or highlighting premium features available elsewhere should be included.
  • A disclaimer must be added to the content (or possibly in the global site footer) that any brand/product/service mentioned is considered a suggestion and not an endorsement.
  • Content must be reviewed and updated if there are any previously mentioned brands that no longer adhere to the trademark/licence requirements above (for example, if they change their licencing or use of the WordPress trademark). A feature for tracking this can be a part of the proposed audit tool.

Regarding the promotion of your own company/brand:

  • Company/brand logos should not appear in videos as far as possible – visuals must aim to be product-neutral and unbranded.
  • You may not highlight your business or otherwise advertise your own products/services as part of any content on Learn WordPress – this includes individuals who create training content professionally. All videos are accompanied by bios of all speakers, so credit will always be given appropriately to the individuals creating the content.
  • The only time where you may highlight your own product when producing content for Learn WordPress is if it is relevant and contextual. For example, if someone who works for Easy Digital Downloads is creating content about using eCommerce in WordPress, then including Easy Digital Downloads as an option alongside other eCommerce plugins would be reasonable so long as it is done according to the guidelines above.

Feedback

Your thoughts on this proposal along the following lines would be greatly appreciated:

  1. Do you think the proposed guidelines are a reasonable way to meet the goals outlined above while remaining in keeping with similar guidelines elsewhere in the community?
  2. Is there anything you would add/change/remove from the guidelines proposed?

Please provide feedback in the comments section. This proposal will be finalised on Thursday, 26 August and will then be implemented for all content hosted on Learn WordPress now and in the future.

References

In order to help establish the above proposal, the following similar guidelines from other contributor teams were examined.

From the WordPress.tv Submission Guidelines:

WordPress TV is a moderated community and the videos we publish are for the benefit of all users of WordPress. As such, our content is meant to be a reflection of the values of the WordPress project; therefore, videos published to WordPress.tv must:

– respect the WordPress trademark,

– embrace the WordPress license,

– only promote WordPress-derivative works (themes, plugins, and other distros) that are suitable for promotion at wordpress.org,

– and be free of spam, incitement to violence, and discrimination of any kind.

From the guidelines for speakers at WordCamps:

WordCamps are official events. Most attendees see you, a bonafide WordCampWordCamp WordCamps 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. speaker, as someone who represents WordPress. In your presentation, you’ll want to make sure you only recommend WordPress products or companies that honor the WordPress trademark and embrace the WordPress license.

From the Support Forum Guidelines:

For support of commercial themes or plugins, go to the official support channel.

In order to be good stewards of the WordPress community, and encourage innovation and progress, we feel it’s important to direct people to those official locations. Doing this will provide the developer with the income they need to make WordPress awesome.

Ultimately, the vendors are responsible for supporting their commercial product.

Thanks to the following people for their input on this proposal: @courane01, @nao, @angelasjin, @harishanker & @dansoschin .

August 2021 Training Team Sprint

The Training team is using the Sprint method to determine what we are working on and to determine our timeframe for delivery.

What is a Sprint?

Sprints are fixed length events of one month or less to create consistency. A new Sprint starts immediately after the conclusion of the previous Sprint.

https://www.scrum.org/resources/what-is-a-sprint-in-scrum

Sprint Goals

Theme: How to contribute to the WordPress Project with screenshots and videos (guidelines for how content within screenshots and videos appear).

Think about these with as much consideration toward accessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) as possible.

Ideally, these guidelines could be adopted by other teams as well, turned into a video series of workshops, and help onboard others into several parts of the project. Additionally, it lifts needing to maintain this from our team handbook into content on Learn.

Learn Content

Lesson Plans

We currently using TrelloTrello Project 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. to manage and keep track of the status of each Lesson Plan. Every Lesson Plan has its own Trello card. The Trello lists represent our Development Workflow, each list contains a card that explains how to use that list.

Lesson Plan and Workshop Ideas

For the cards in this list:

  • Finalize description
  • Set objectives (goals)
  • Research and add links to support and developer docs
  • Identify marketing communications
  • Carry out an SEO review.
  • Review related material on Learn
  1. Trial run on a lesson plan and workshop about overcoming Imposter Syndrome by @lepittenger as part of Web Dev Studios 5FTF to be included in the speaker series

Next Up – You Can Help!

  1. Site Backup
  2. Migrate, Copy, or Clone a Site
  3. Introduction to Gutenberg
  4. How to Configure WordPress Installation for Contributor and Developer Testing @woodnet @caseymilne @paaljaochim
  5. Testing a Trac ticket or GitHub PR @woodnet @caseymilne @paaljaochim

Drafts in Progress

  1. How to create a blog post in WordPress 5.x @geheren

Instructional Review

  1. Using a browser inspector@woodnet – revising screenshots

Copyediting in Progress

Annotation options@cousett merged with Zooming in, how to crop for enough focus and context, aspect ratios@courane01

Style Guide Review

  1. What to do when you forget your password@webtechpooja

Ready for Final Review

  1. When to use browser dev tools inspector to override some information (hiding your name) @cousett
  2. Sample content – Theme Unit Test Data, Gutenberg Blocks Data, Monster Widget @cousett

Audit

  1. What to do when you forget your password @webtechpooja

Workshops

  1. Coming Soon

Learn Functionality

  1. Continue Slides pluginPlugin A 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 proposal after Learn Working Group consideration
  2. Style a print-friendly style sheet (transcripts and lesson plans)
  3. Use a blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. layout in a page to create much of the lesson plan page organization https://github.com/WordPress/learn/issues/153
  4. Coordinate about audit tool feature request with #docs, #marketing, and other relevant teams
  5. Consider partnering with Five for the Future contributors for Learn functionality.

Training Team

  1. Publish initial draft for Brand guidelines, seeking specific feedback. (awaiting further input with #Marketing)
  2. Audit Learn Functionalitly Trello board
  3. Deputy program
  4. Update Training Team and Learn Handbook
  5. Schedule Learn Stakeholder meeting
  6. Conduct a retrospective on the previous sprint.
  7. Complete the revision of the Handbook
  8. Begin the Deputy program for vetting content on Learn within Training
  9. Consolidate the roadmaps to learning WordPress with the languages as well.

You are welcome to join the team at any time! If you are new to the Training Team, please introduce yourself in the #training channel before the meeting (or anytime!) and feel free to join us in the meeting and participate as you are able.

Training Team Mission

The WordPress training team helps people learn to use, extend, and contribute to WordPress through synchronous and asynchronous learning as well as downloadable lesson plans for instructors to use in live environments, via learn.wordpress.org.

Getting Involved

Everyone is welcome and encouraged to join in, comment on posts, and participate in meetings and on projects. Here’s what you need to know to get started.

Team Links

  1. Getting involved:- https://make.wordpress.org/training/handbook/getting-started/
  2. About The Team:- https://make.wordpress.org/training/handbook/about/ 
  3. Our Team Blog:- https://make.wordpress.org/training/ 
  4. Our Content Roadmap:- https://trello.com/b/BsfzszRM/wordpress-training-team-lesson-plan-development 
  5. Learn WordPress Roadmap:- https://trello.com/b/rK1tztAA/learn-wordpress 
  6. Our Lesson Plans:- https://learn.wordpress.org/lesson-plans/
  7. Our YouTube Channel:- https://www.youtube.com/channel/UCnxqNA0WORZXWurEP6cNV6w 
  8. Learn Website:- https://learn.wordpress.org/

#learn-wordpress, #learnwp, #sprint, #training-team