Docs: Description is wrong in the return of block_version()

[mukesh27]

Description is wrong in the return of block_version()

current description is:

* @return int The block format version.

must be:

* @return int 0 if the string doesn't contain blocks, 1 otherwise.

[mukesh27]

Patch

[birgire]

Related #43887 and ​https://github.com/WordPress/gutenberg/issues/6435

It seems that the idea was to have the possibility to increment the block version if breaking changes are introduced in the future.

It looks like a good improvement, as suggested by @mukesh27, to explain the possible return values, that are currently either 0 or 1.

Here's are suggested adjustments for 45342.patch​, to e.g. avoid starting the description with a number:

* @return int The block format version is 1 if the content contains one or more blocks, 0 otherwise.

[mukesh27]

@birgire thanks for your suggestion.

[desrosj]

@mukesh27 can you refresh the patch with the updated suggestion, please?

[mukesh27]

Updated patch.

[mukesh27]

@desrosj please check updated patch.

[desrosj]

Thanks for the update, @mukesh27. Looks like a good improvement to me.

[youknowriad]

In 43924:

Block Editor: Clarify PHP Docs of the block_version function.

Clarify the return value.

Props desrosj, mukesh27.
Fixes #45342.

[youknowriad]

Commited as I got an approval from @matveb

[youknowriad]

Oh I forgot to prop @birgire For this one. Not sure how we can fix that process wise?

[desrosj]

In 44270:

Block Editor: Fix PHP warning when loading editor styles while in RTL.

In RTL languages, WordPress adds style-editor-rtl.css editor styles to the global $editor_styles.
This patch ignores handling these styles if the file is not preset.

Also, clarify the docs for the return value of the block_version function.

Props mostafa.s1990, desrosj, mukesh27.

Merges [43923] and [43924] to trunk.

Fixes #45288, #45342.