-
Notifications
You must be signed in to change notification settings - Fork 4.2k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
6.1 Dev Notes Tracking #42961
Comments
@ramonjd and all Publishing close to RC 1 is not a hard rule. It only makes sure that there isn't something in the dev notes, the might have changed between drafting it and release. On the doc release team we need a bit of a lead time as Dev Notes need to be reviewed by two people before publishing. If all dev notes are published a day before RC 1, it creates an unnecessary bottleneck and undue stress on the team. Ideally, the draft on the make blog could be available around Beta 1. Then it can get into the queue for reviewers, finalized and published by RC 1, to make it into the Field Guide. |
Thanks for the ping @bph! For this one, I don't believe a separate post is required, it can be added to any dev note blog post on smaller changes. I've drafted a comment on the PR for inclusion in such a post: #42544 (comment) — the main purpose of the dev note is to communicate to creators of themes that currently use an undocumented approach of opting out of Layout styles to use the new formal approach. |
Thank you, @andrewserong - I marked this dev note as done for now. |
Thanks @ramonjd for message about the Draft Dev Note ready for review 👏 🙌 |
Draft for spacing presets available for review at https://make.wordpress.org/core/?p=98177&preview=1&_ppp=00c8d7730a |
I commented on the above PR because I thought it should be mentioned in the dev note. |
Thank you so much @t-hamano to add this here and put this on our radar for WP 6.1. |
@bph I created a draft for elements support: https://make.wordpress.org/core/?p=98557 |
#42677 (comment) |
@scruffian Thanks for the Dev Note! and the link! |
I've listed the authors of #43840 in the issue description. I was listed but I was involved. |
👋 - I was wondering if all the additions in the templates offered to create in site editor should be part of post like this already posted one: https://make.wordpress.org/core/2022/07/21/core-editor-improvement-deeper-customization-with-more-template-options/. Related PRs that
For Query Loop extensibility PRs, there is going to be a documentation page(related open PR), so I guess that would be enough? 🤔 Finally for the Query Loop parents filter is just a filter for the block to restrict the results based on their parent. I don't think it needs a separate dev note, but if we want we could add somewhere a sentence about it like:
|
I started a draft post for Block API changes covering:
For the Create Block section, there is also an open PR that we should land closer to the release date that integrates the new Besides, we should mostly cover new CLI options / prompts that allow selecting different variants (dynamic vs static) and a way to scaffold code only for a block (without the plugin wrapper). |
I've added a draft note for the layout refactor in this comment (#40875 (comment)). The layout dev notes will likely all be consolidated with ones from @tellthemachines and @ramonjd into a single blog post, since lots of the individual PRs and changes are all related. |
@tellthemachines I updated the tracking section above. |
I added a dev note for pseudo class support for |
I added a short dev note for this. https://make.wordpress.org/core/?p=98980&preview=1&_ppp=56c57f986f |
Hey folks, there's a draft post for all Layout-related dev notes here: https://make.wordpress.org/core/?p=99019&preview=1&_ppp=992173a9ba |
I've thrown up a first draft for the Style Engine dev note here: https://make.wordpress.org/core/?p=99063&preview=1&_ppp=10ef94cb0b Thank you! |
I've noticed that in the 6.1 cycle there has been a few features introduced in
I suggest that we create a "theme.json in WordPress 6.1" devnote to compile them all (whether or not some of those individual features merit its own devnote as well). cc people that led the changes in this area in case anyone wants to draft it up. @scruffian @MaggieCabrera @mikachan @ajlende @getdave @draganescu @glendaviesnz @andrewserong @ramonjd @aaronrobertshaw |
Here's the Dev Note for this. |
@oandregal looking at your list in your comment This is the current list of stand-alone Dev Notes already drafted on the Make Blog:
This is the list of theme.json PRs. See link list above. |
@jorgefilipecosta @t-hamano We already have a "Block Library Updates" (public preview) Dev note in the works, where we can add a paragraph about these PRs And if you can, also for #40554 What do you think? You can add it all in a comment on this issue together. |
@bph combined dev note for the create-block stuff. Create-Block Dev notes WP 6.1#WordPress 6.1 introduces many updates and new features to the @wordpress/create-block. New FeaturesBlock VariantsThe new Scaffolding using the dynamic variant:
Template authors can define variants by adding a Related pull requests: –no-plugin modeA highly requested feature for the package was to be able to add additional blocks to an existing plugin. With the addition of the When the command is run with the flag, a new set of block files will be created in the directory where the command was run in a directory named for the slug passed.
Related pull requests: #41642 Enhancements:
DocumentationThe documentation around creating External Templates has been split into its own section ( #43718) and links to the documentation in the associated create-block-tutorial-template have been fixed to link to the correct places ( #42839 ). @bph Make draft if here: https://make.wordpress.org/core/?p=99350&preview=1&_ppp=79a1db742d |
Extending the Query Loop blockExtenders needed a way to present bespoke versions of the Query Loop block, with their own presets, additional settings and without customization options which are irrelevant to their use-case. With WordPress 6.1 the Query Loop block offers very powerful ways to create such versions, through block variations. To make Wordpress recognize your variation you need to set the Query Loop block now supports controlling which filters are displayed in the user through the allowedControls property, making it easier to be configured by users. Now you have control over the query executed to fetch the desired posts. You can change the query executed in the block editor by setting extra arguments to the Customizing Query Block LayoutTo customize your variation's layout you can use the An example block variation would look like this: const MY_VARIATION_NAME = 'my-plugin/books-list';
registerBlockVariation( 'core/query', {
name: MY_VARIATION_NAME,
title: 'Books List',
description: 'Displays a list of books',
isActive: [ 'namespace' ],
icon: /** An SVG icon can go here*/,
attributes: {
namespace: MY_VARIATION_NAME,
query: {
perPage: 6,
pages: 0,
offset: 0,
postType: 'book',
order: 'desc',
orderBy: 'date',
author: '',
search: '',
exclude: [],
sticky: '',
inherit: false,
},
},
allowedControls: [ 'inherit', 'order', 'taxQuery', 'search' ],
scope: [ 'inserter' ],
); There is a new documentation page specifically for extending Query Loop block to learn more. props @sunyatasattva for the documentation page. make.wordpress draft: https://make.wordpress.org/core/?p=99476&preview=1&_ppp=c35ff058a0 |
@bph I've looked into changes and don't see anything left. People that worked actively in this area may want to double-check, cc @scruffian @ajlende @MaggieCabrera etc. |
I will leave a note which should be added in the Block Libraries update in WordPress 6.1 post. This note refers to three PRs:
If there are any misleading or unnatural phrases, please feel free to update them. Navigation Block Menu Items filterContent has already been created by @afragen. Improvement of Cover BlockMarkup changesThe markup has been changed to resolve the issue that duotone doesn't work with fixed background. Previously, the background image was applied to the root of the block, but it is now applied to the inner Current:
New:
For more info see #40554. Keep the same position for both LTR and RTL languagesIn the cover block, the content inside can be changed the content position, such as "Top Left" or "Center Right". But when changed to RTL languages, the content position flips left to right as compared to the LTR language. However, content position determines "physical" placement and should not be affected by language direction. To solve this problem, the same position is now kept for both LTR and RTL languages. Because of this change, the content within the existing cover block in RTL languages is flipped left to right (i.e., in its original position), but if this is not what you are looking for, you can re-position it. For more info see #43663. Global template_lock inheritance in the column blockThe block template defines a default list of blocks in an editor session. To prevent manipulation of the block list, all blocks can be locked by template_lock property. However, in column blocks, the editor would crash on certain operations because it would initialize the lock status defined in the block template. To resolve this issue and to be more consistent about template lock status inheritance, column blocks now inherit the lock status of block templates. For more info see #42677. |
Awesome, Thank you @t-hamano ! |
Just to let everyone know, I've been going through the drafts at Core blog and adding Thank you for awesome work ❤️ |
I have been doing that, to and I added |
Yeah, but |
Update: October 8th, 2022Yesterday, 4 dev notes were published, six are finished and in the queue to be reviewed, one is still in progress. Published 📣
In Review 👓
In Progress 📝Block API changes in WordPress 6.1 Not claimed PRsIn the list in the issue description above we still have a few white check boxes next to PRs.
|
@bph Could we possibly hold off on publishing the fluid typography dev note for a few days? There are some bugs we're scrambling to iron out and it will affect the content of the dev note, which I will update in due course. See: 🙇 |
Persisted preferences - https://make.wordpress.org/core/wp-admin/post.php?post=99657&action=edit Writing this did make me realise there's a bug in 6.1 RC related to the backport for persisted preferences, so I'll work on fixing that asap. 🤦♂️ |
Oh, I forgot commenting about the settings hook. This is something client-specific and unrelated to server-side filters. It's about having a theme.json per block instance. Not all pieces to make this work have landed in 6.1, so I'm leaning towards not publishing the devnote just for now. cc @jorgefilipecosta in case he has thoughts. |
Yes, I agree it is something experimental that we will continue trying on the plugin. The dev note should not go out for now. |
@bph I've added a dev note for #44494 as a comment in the PR: #44494 (comment). |
I've added two dev notes for Block Editor misc post - #40502 (comment) and #42186 (comment). |
Here I add the missing dev note for #41791. Start content patterns for all post types.With WordPress 6.0, we introduced the ability to add patterns that appear in a modal each time a new page was created, allowing the user to start from a set of pre-made patterns instead of in a blank state. In WordPress 6.1, this feature is expanded to all the post types.
|
I have questions about ‘connecting’ a pattern with a Query Loop variation, mentioned in the section “Customize your variation layout”: “In order for a pattern to be “connected” with a Query Loop variation, you should add the name of your variation prefixed with the Query Loop name (e.g. core/query/$variation_name) to the pattern’s blockTypes property. For more details about registering patterns see here.” I don’t quite understand, and it’s not working for me. It will be great if there’s a simple example on how to connect a pattern with a query loop variation. I do have the variation created in the js file, using registerBlockVariation(), similar to the examples that you have above. My variation name is 'my-test-variation'
I have registered a pattern using register_block_pattern() in my functions.php, like below:
What am I missing? Thank you! |
Tracking all Dev Notes from Gutenberg plugin releases 13.1 - 14.1
After a review of the processes establish during 6.0 release cycle, the release leads for documentation agreed on some modifications. Please read the information below carefully. If you have questions, connect with @bph or @zzap via Slack or comment here.
Not all developer related information needs to be in a separate DevNote on the Make Core blog for the field guide. We can group related information.
During the course of the next few weeks, this first list will be completed after the last Gutenberg plugin.
We can already make decision on some features if warrant a stand-alone blog post or if the information will be part of a group post.
Stand-alone post
To streamline the process and eliminate bottlenecks, all writers of stand-alone dev notes will receive privileges on the Make Core Blog. (Please connect with @bph or @zzap, if you need access)
Part of a group post
If the information related to your PR will be part of a group post, please write the dev note in a comment on the PR, so it can be reviewed and, if necessary commented on, by the release docs team or a reviewer.
Before you start writing
Global Styles
global_styles_*
totheme_json_*
#44159 @oandregalsettings
hook #40547 @oandregalLayout
Elements support @scruffian
elements
in theme json #41786Fluid typography @ramonjd
Create Block Scaffolding Tool @gziolo / @ryanwelcher
--no-plugin
flag to scaffold only block files. #41642--variant
flag to allow creation of different block type variants #41289Style Engine @ramonjd @andrewserong
Block Library (Package)
Query Loop @ntsekouras
allowedControls
in block variations for better extensibility #43632parents
filter #40933Components package
Margin deprecation @mirka (dev note here)
Popover @ciampo (dev note here)
anchor
prop #43691 @ciampoNew APIs
build_query_vars_from_query_block
#43590 @sunyatasattvarender
field toblock.json
#42430 @gziolouseDisabled
hook + disabled componentDeprecated
Unsorted for now
templateLock
value fromnoContent
tocontentOnly
#44131theme.json
$schema
to account for pseudo selector support #41936Preference Persistence
Update 10/8
removed - #42485 not in 6.1
Updates: 10/03 - bph
several more PR references
Updates: 9/21 / - bph
to be continued
The text was updated successfully, but these errors were encountered: