Learn icon indicating copy to clipboard operation
Learn copied to clipboard

The New Core Dev WorkFlow

Open SirLouen opened this issue 6 months ago • 6 comments

Description: Currently, we are revamping the Workflow for Core team. There is much confusion and most contributors have been historically assigning action keywords wrongly (or not assigning at all, probably because of not knowing about them). Keywords are very important because they ultimately help push tickets to an end. Not setting keywords leave most almost finished patches lost in oblivion.

Audience: The main audience is any current or future contributor that wants to learn how to do things well and confidently when they are introduced into the Core contributor's world, from a workflow perspective

Learning Objectives:

  1. Learn the purpose of the most important and popular keywords
  2. Learn how to correctly assign keywords according to the work done
  3. Learn how to search based on the different keywords and understand how anyone could be useful to Core, both technical and non-technical contributors

Content Type: I'm planning to do two formats:

  • An onboarding course, explaining the main keywords, the most used ones, text based.
  • A more in-detail course, probably in video
  • Maybe in the future depending on the interest, a second "Advanced" including all the less used keywords, but for now, only these 2.

I will be creating this content

Related Resources

  • Current version Trac Workflow Keywords (still pending to be updated with the new version). I'm willing to create this course in advance as a companion for the revamp so people can start working with the right foot after publishing.
  • Gutenberg workflow overview by annezazu, this was the first resource that got my attention. Gutenberg has been doing a great job and I found that Core had to catch up some months ago, this is why we started the revamping process.

SirLouen avatar Jun 03 '25 13:06 SirLouen

Vetting Checklist for SMEs

  • Priority - either High, Medium, or Low: High, since @SirLouen proposed that this project should be done in advance and before updating the Current version Trac Workflow Keywords to the new version
  • Feedback regarding the topic description: The topic description is clear. The author explained the reasons for creating this WorkFlow project and clearly explained the steps that should be taken.
  • Feedback regarding the learning objectives: Learning objectives are valid, clear, and concise.
  • Any other feedback: This is something that will help in the onboarding process of new contributors to the Training team, and if @SirLouen is available to work on this project, I think it is good to go to the next phase.

@devmuhib009

rjekic avatar Jun 04 '25 17:06 rjekic

Hi @SirLouen

I've added this to Content Development board, whenever you are ready, you can start making the content. Here are resources related to course and lessons. https://make.wordpress.org/training/handbook/courses/ https://make.wordpress.org/training/handbook/lessons/lesson-tasks/

Thanks

devmuhib009 avatar Jun 06 '25 14:06 devmuhib009

Hello @devmuhib009

https://make.wordpress.org/training/handbook/lessons/lesson-tasks/

Let me see. This is technically a full course, not a single lesson

Like this one: https://learn.wordpress.org/course/how-decisions-are-made-in-the-wordpress-project/

I'm thinking on creating 4 lessons

  • Lesson 1: The Triaging Group
  • Lesson 2: The Development Group
  • Lesson 3: The Testing Group
  • Lesson 4: The Code Review Group * (this is still pending to be confirmed though)

For now, I believe I will take this from a "Basic" perspective, like to be as helpful and instructional as possible for new contributors I think that the "advanced" version, with extra information for each of the 4 groups and 2 new lessons called "The Committing Group" and the "The Backporting Group", can wait for the future

This said, I might start working on this after next <dev-chat> meeting (11th June), where I want to confirm if members are fine with this structure (and it won't be probably final until 3 or 4 extra meetings, where some reviewers jump in and review the content).

This said, how the text content should be submitted? Do I have access to some tool within learn.wordpress.org (like the submission form in WPTV) ?

SirLouen avatar Jun 06 '25 14:06 SirLouen

Hi @SirLouen

Thank you for sharing your plan! It sounds like a well-structured approach, and it's absolutely fine if you need additional time for review and feedback during the upcoming meetings. Taking 3-4 extra meetings for finalizing the structure and incorporating input from reviewers is a great idea to ensure the lessons are as effective as possible.

Regarding submitting the text content, you’ll need access to the Learn WordPress platform. Please apply as a content creator on Learn WordPress, and we’ll make sure you have the necessary access to get started. Let me know if you need any assistance with the application process! https://make.wordpress.org/training/handbook/getting-started/content-creator-onboarding/

Thanks

devmuhib009 avatar Jun 06 '25 15:06 devmuhib009

Hello @devmuhib009

Regarding submitting the text content, you’ll need access to the Learn WordPress platform

I have not received any news regarding this topic (I sent the form in the URL you sent me some weeks ago) Many people in Core are asking me and I since I have no ETA on when I'm going to have enabled this section to start adding content, I could not say anything to them. Can you update me on something? Thanks!

SirLouen avatar Jun 30 '25 10:06 SirLouen

Hi @SirLouen I just checked the Ticketing system, it seems no application was found as content creator. Please check your Slack inbox, I am going to DM you to speedup the process.

Note: Add you as Content Creator in learn.wordpress.org

devmuhib009 avatar Jun 30 '25 11:06 devmuhib009