Our 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
The first step to getting new quality content on Learn WordPress is to vet the various content topic ideas shared by the WordPress community. These ideas can stem from personal interest to crowdsourced consensus, but no matter how it comes to the Training Team, it will require vetting before it is greenlit for content creation and publication on the Learn WordPress website.
Subject Matter Experts (SMEs) are Faculty Members who utilize their expertise to vet submitted content topic ideas. In general, SMEs look to assess these ideas for accuracy, relevance, and priority.
Outlined below are the guiding processes for vetting content topic ideas for Learn WordPress.
The following access is required to vet content topic ideas for Learn WordPress:
Learn Content Triage membership on 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/
Subject Matter Expert (Either Faculty or a vetted Training Team member)
Please contact a Training Team Representative or Faculty Member in the #training Slack channel if you lack the appropriate access to perform this work.
All new Topic Ideas are created as a GitHub issue on the Learn GitHub repository using the Topic Ideas GitHub issue Template. These issues include details such as the topic title, description, objective, content type to help guide their assessment.
Further outlined in this section are the processes for vetting all content topic ideas and specific content types.
Topic relevance (Ex. Is it timely with the latest releases and/or up to date with the latest practices? Does it follow our Promotional Guidelines or GPLGPLGPL 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. best practices?)
Priority (Low – Med – High); this is assessed by whether or not the topic is critical to something in the latest release, hits on a needs analysis trend, or fixes a gap in previously published foundational content
Feedback on what could be added / removed / edited about the topic
Appropriateness of objectives set for the topic
Timeline for completion (Ex. If the issue is release related, it should be prioritized by a Training Team Release Coordinator. If it is misc, it can be prioritized by others.)
It can sometimes be difficult to assess topic ideas on an individual level, so don’t hesitate to reach out to other Subject Matter Experts or the Training Team reps as you work through it for a second opinion.
Tutorials: Check if a tutorial with the same topic already exists in the dashboard’s Tutorials section either with a published or to be published status– vetters must check in the dashboard, rather than the frontend in case a similar tutorial is awaiting publication.
Lesson Plans: Check if a lesson plan with the same topic already exists in the dashboard’s Lesson Plans section either with a published or to be published status.
Courses: Check if a course with the same topic already exists in the dashboard’s Courses section either with a published or to be published status.
Next, check if there is a similar topic idea already in GitHub by searching through the Topic Ideas column on the project board; additionally, look for any cross-linked GitHub issues that may have affiliated content but be of a different content type (Ex. Lesson Plan vs. Tutorial) for collaboration suggestions.
Product type (theme, 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)
Version (milestone 5.9)
Content CategoryCategoryThe 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. (Ex. PHPPHPPHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML. http://php.net/manual/en/intro-whatis.php., GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/, BlockBlockBlock 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. Theme)
Assign the Content Creator if it’s the noted in the ticket, otherwise assign it to a Faculty Administrator or 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. for assignment and apply the “Needs Content Creator” label
If you find a published content on the Learn WordPress website that is similar in content to the new topic idea, then “close with comment” on the GitHub issue with a link to the existing one and let the topic submitter know that the content already exists.
If you find a similar topic idea in GitHub, then comment on the GitHub issue with a link to the existing topic idea issue and add any updates as needed from the new submission. Once this is done ”close with comment” with a link to the similar topic idea issue.
If the topic idea submitter has indicated that they would like to create the approved content:
then send them the Tutorial Presenter application and let them know that they will be assigned to the existing issue once they have been approved or;
if they are an approved Tutorial presenter, assign them to the issue and move the issue to the `Ready to Create` column on the project board.
If the topic submitter does not want to create the approved content, move the issue to the `Ready to Create` column and add the `Needs Content Creator` label
The `Triage Checklist` must be completed before the issue is closed or moved to the `Ready to Create` column.
Note that some Topic Ideas may require multiple content types to be created, in this case a GitHub issue should be created for each content type and a link back to the related content issues should be provided in the body of the issue to allow for cross-collaboration or reference.