Block support docs: update blockGap notes

[ramonjd]

What?

Update block support docs to reflect the curiosities of block gap.

Why?

In response to an API update: #41098

How?

Keyboard

[andrewserong]

Nice one, thanks for updating the docs @ramonjd, this reads well to me!

I was wondering if it'd be worth us also stabilising the __experimentalDefault prop at the same time (switch it over to default) based on this comment in the other PR: #41098 (review). What do you think? Worth stabilising, or is it still a little up in the air, given we're doing lots of layout exploration at the moment?

(From my perspective, we're exploring changing lots of things, but being able to set a default fallback value at the block level in block.json probably isn't one of the main areas we're looking at changing up... 🤔)

[ramonjd]

I was wondering if it'd be worth us also stabilising the __experimentalDefault prop at the same time (switch it over to default) based on this comment in the other PR: #41098 (review). What do you think? Worth stabilising, or is it still a little up in the air, given we're doing lots of layout exploration at the moment

Oh definitely, good point!

I wasn't sure, and to be honest, probably just focussed on the "let's document this" part 🤣

I did notice we had nothing about blockGap so I can get rid of the text describing the __experimentalDefault feature for now. It'll stay in the commit history for later use 😄

[andrewserong]

I did notice we had nothing about blockGap so I can get rid of the text describing the __experimentalDefault feature for now. It'll stay in the commit history for later use 😄

Sorry for the late reply, I missed the notification! Yes, sounds good to remove the __experimentalDefault feature for now, and we can add back in the docs when we look at stabilising it to default 🙂

[andrewserong]

Read well to me, thanks for the improvement here!