WordPress.org

Making WordPress.org

Opened 12 months ago

Last modified 2 months ago

#3644 new task

Remake of the learn.wordpress.org site

Reported by: juliekuehl Owned by:
Milestone: Priority: normal
Component: learn.wordpress.org Keywords: dev-feedback ui-feedback ux-feedback
Cc:

Description

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?

Attachments (3)

WordPress Training Team Learn Site.pdf (409.1 KB) - added by juliekuehl 12 months ago.
Draft wireframes for learn.wordpress.org for discussion
learn_org.pdf (4.5 MB) - added by batcatforever 9 months ago.
Research
learning_theme_specificiations.pdf (4.4 MB) - added by batcatforever 3 months ago.
Annotations relating to functionality & theme structure

Change History (13)

@juliekuehl
12 months ago

Draft wireframes for learn.wordpress.org for discussion

#1 @netweb
12 months ago

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

This ticket was mentioned in Slack in #design by michelemiz. View the logs.


12 months ago

@batcatforever
9 months ago

Research

#3 @batcatforever
9 months ago

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

#4 @juliekuehl
6 months ago

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

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

#5 @juliekuehl
6 months ago

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

#6 @ocean90
5 months ago

#4014 was marked as a duplicate.

#7 @juliekuehl
4 months ago

  • Keywords needs-design removed

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.

#8 @juliekuehl
3 months ago

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.

This ticket was mentioned in Slack in #meta by juliekuehl. View the logs.


3 months ago

@batcatforever
3 months ago

Annotations relating to functionality & theme structure

Note: See TracTickets for help on using tickets.