Remake of the learn.wordpress.org site

[juliekuehl]

The Training Team has a dream and would like to ask for help with the learn.wordpress.org (aka Learn) site. We have progressed far enough with updating our infrastructure and processes to want to begin thinking about the final location for our lesson plans once they are completed.

We imagine that the use case of the learn.wordpress.org site would be as a place for people who are planning meetups and workshops to go to and search for ideas and resources for their event. For example:

• Meetup organizer: “I have a one-hour meetup coming up where we’d like to talk about site backups”
• Workshop organizer: “I have a half day where we want to help onboard people new to WordPress”

It is thought that they will have a few things in mind when the come to the page:

• an audience (users, designers, developers, speakers, etc.)
• a duration (time constraint)
• a topic, even if very general
• possibly an teaching strategy (e.g., lecture, demonstration, hands-on exercises, etc.)
• others?

Therefore would would like to be able to help them search and filter resources by those criteria.

We have requested help from the Design Team (​https://trello.com/c/uOqHGjCC) but took the liberty of creating a first draft of wireframes, which are attached. We offer them up as a starting place for further discussion.

We do not yet have fully vetted material to publish on the site. It was thought that we should work with the Design Team and the Meta Team before that point as we would be happy to make adaptations for a better design and user experience.

Our lesson plans are currently being worked on in GitHub (​https://github.com/wptrainingteam) and we are managing our work on a Trello board (​https://trello.com/b/BsfzszRM/wordpress-training-team-lesson-plan-development).

A couple of pieces of the dream are that it would be possible to:

• Push a big red button and send a completed lesson plan from GitHub to the Learn site.
• Have one theme for all the lesson plan slides. That might require a place for “master” CSS and JS files. (Each lesson plan would have the HTML file.)
• Bundle those CSS/JS/HTML file for downloading for offline use

Can you help us think this through, let us know what is possible, and help build it out?

[juliekuehl]

Draft wireframes for learn.wordpress.org for discussion

[netweb]

Welcome to Meta Trac Julie and thanks for creating the ticket :)

I've spoken to Julie in Slack in regard to the above proposal and my suggestion was to use the "GitHub Markdown importer" currently being used for the wp-cli and REST-API docs hosted at ​https://developer.wordpress.org

The training team currently have ~100 lesson plans hosted on GitHub, each repo is its own lesson plan, each lesson plan has a standardised structure:

images (image assets folder)
slides (slides folder)
LICENSE
README.md (The lesson plan)

---

Looking at how the above tool would address the teams dreams:

Push a big red button and send a completed lesson plan from GitHub to the Learn site.

The training team would maintain a ​manifest.json containing the lesson plans that would be required to be sync'd to ​https://learn.wordpress.org by the "GitHub Markdown importer". Each time a new lesson plan is ready for deployment adding a new entry to the manifest.json file would be that "big read button" and would then be automaticly sync'd to ​https://learn.wordpress.org/

Have one theme for all the lesson plan slides. That might require a place for “master” CSS and JS files. (Each lesson plan would have the HTML file.)

A new theme for ​https://learn.wordpress.org site can be created or adapted from any of the existing themes such as wporg-developer or Gutenberg themes once feedback from the Design team has been received.

Bundle those CSS/JS/HTML file for downloading for offline use

This would be part of the above theme functionality, possibly also supporting Markdown and PDF exports

Related:

• #3593 to "Centralize GitHub Markdown Importer" as a couple of variations of this tool currently exist.
• #3377 Sync Coding Standards content from GitHub to DevHub

[batcatforever]

Research

[batcatforever]

Research attached. Showing some current learning organization methods in WP and from other learning websites

[juliekuehl]

The mockups created by @batcatforever and the Design Team can be found at:

​https://wp.invisionapp.com/share/BNP0V7QXRF8#/screens/330323713

[juliekuehl]

Training Team's Trello card: ​https://trello.com/c/ck3UjgcA

Design Team's Trello card: ​https://trello.com/c/uOqHGjCC

Marketing Team's Trello card: ​https://trello.com/c/QCUfsrav

[ocean90]

#4014 was marked as a duplicate.

[juliekuehl]

The design mockups are complete. We are now making changes to our GitHub organization to place all the lesson plans within the ​https://github.com/wptrainingteam/learn repo.

[juliekuehl]

The "master" repo (​https://github.com/wptrainingteam/learn) has now been set up with the information for all of our lesson plans in one place.

I believe we are now ready to move forward with development of the ​https://learn.wordpress.org/ site.

[batcatforever]

Annotations relating to functionality & theme structure

[juliekuehl]

The code for the theme for learn.wordpress.org is over at https://meta.trac.wordpress.org/browser/sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-learn

[jonoaldersonwp]

Is this project dead? If so, I'd like to remove the current learn.wordpress.org site for SEO + marketing reasons.

[juliekuehl]

Absolutely not! We have been working for over a year to get it moving forward and could use some help getting it in place.

[jonoaldersonwp]

Ah, good news!

[dd32]

I'm going to close this as fixed, although many parts may not have been implemented as suggested.

The ​https://learn.wordpress.org/ site has had a major overhaul recently, if others would like to make specific contributions ​https://github.com/wordpress/learn is the new home for tracking issues.