Skip to content

Commit

Permalink
Clarify contents of experimental bundle in comments and readme
Browse files Browse the repository at this point in the history
  • Loading branch information
jeherve committed Dec 19, 2019
1 parent be04755 commit 8f12adb
Show file tree
Hide file tree
Showing 2 changed files with 5 additions and 1 deletion.
5 changes: 4 additions & 1 deletion extensions/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,13 +55,16 @@ Generally, all new extensions should start out as a beta.

- Before you develop, remember to add your extension's slug to the beta array in `extensions/index.json`.
- In the `wp-config.php` for your Docker environment (`docker/wordpress/wp-config.php`) or in your custom mu-plugins file (`docker/mu-plugins/yourfile.php`), enable beta extensions with the following snippet: `define( 'JETPACK_BETA_BLOCKS', true );`
- When you use this constant, you'll get all blocks: Beta blocks, Experimental blocks, and Production blocks.
- In the WordPress.com environment, Automatticians will be able to see beta extensions with no further configuration
- Once you've successfully beta tested your new extension, you can open new PR to make your extension live!
- Simply move the extension's slug out of the beta array and into the production array in `extensions/index.json`.

### Experimental Extensions

We also offer an "experimental" state for extensions. Those extensions will be made available to anyone having the `JETPACK_EXPERIMENTAL_BLOCKS` constant defined in `wp-config.php`.
We also offer an "experimental" state for extensions. Those extensions will be made available to anyone having the `JETPACK_EXPERIMENTAL_BLOCKS` constant defined in `wp-config.php`. When you use this constant, you'll get Experimental blocks as well as Production blocks.

Experimental extensions are usually considered ready for production, but are served only to sites requesting them.

### Testing

Expand Down
1 change: 1 addition & 0 deletions webpack.config.extensions.js
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ const presetExperimentalBlocks = [
...presetProductionBlocks,
..._.get( presetIndex, [ 'experimental' ], [] ),
];
// Beta Blocks include all blocks: beta, experimental, and production blocks.
const presetBetaBlocks = [ ...presetExperimentalBlocks, ..._.get( presetIndex, [ 'beta' ], [] ) ];

// Helps split up each block into its own folder view script
Expand Down

0 comments on commit 8f12adb

Please sign in to comment.