[wp-meta] [Making WordPress.org] #5020: Source block editor docs from WP branch

Making WordPress.org noreply at wordpress.org
Mon Feb 10 01:29:37 UTC 2020


#5020: Source block editor docs from WP branch
----------------------------+--------------------
 Reporter:  chrisvanpatten  |      Owner:  (none)
     Type:  enhancement     |     Status:  new
 Priority:  normal          |  Milestone:
Component:  Developer Hub   |   Keywords:
----------------------------+--------------------
 Once #5019 lands, we'll be back to using `manifest.json` for the sole
 build of the block editor docs.

 Now that we're past the confusion of `manifest.json` and `manifest-
 devhub.json`, I'd like to propose "locking" the block editor docs to the
 current version of WordPress. Docs for the "bleeding edge" Gutenberg
 plugin will still be available in the repo. This has been a source of
 confusion in the past (including for myself, and I know it's happening!)
 because the developer.wordpress.org site is expected to be the
 documentation for core, not the plugin.

 The easiest way to implement this will be to wait for Gutenberg to create
 the WP release branch for the 5.4 cycle, and use that in the manifest URL,
 e.g.:

 `https://raw.githubusercontent.com/WordPress/gutenberg/wp/5.4/docs/manifest.json`

 This will mean the process is somewhat manual (it will require a meta
 commit every time a new major core release occurs) but I think it's the
 easiest way to make sure the primary documentation source reflects what's
 in core, rather than the latest changes in the plugin. If this solution is
 suitable, perhaps there could be an effort during the 5.4 release cycle to
 see if this can be automated.

-- 
Ticket URL: <https://meta.trac.wordpress.org/ticket/5020>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org


More information about the wp-meta mailing list