[wp-meta] [Making WordPress.org] #3644: Remake of the learn.wordpress.org site

[Making WordPress.org]

#3644: Remake of the learn.wordpress.org site
-------------------------------------------------+-------------------------
 Reporter:  juliekuehl                           |       Owner:  (none)
     Type:  task                                 |      Status:  new
 Priority:  normal                               |   Milestone:
Component:  learn.wordpress.org                  |  Resolution:
 Keywords:  needs-design dev-feedback ui-        |
  feedback ux-feedback                           |
-------------------------------------------------+-------------------------

Comment (by 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
 [https://github.com/WordPress/gutenberg/blob/master/docs/manifest.json
 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
 [https://meta.trac.wordpress.org/browser/sites/trunk/wordpress.org/public_html
 /wp-content/themes/pub/wporg-developer wporg-developer] or
 [https://meta.trac.wordpress.org/browser/sites/trunk/wordpress.org/public_html
 /wp-content/themes/pub/gutenberg 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

-- 
Ticket URL: <https://meta.trac.wordpress.org/ticket/3644#comment:1>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org