Add @since notation to block-library PHP files

[tellthemachines]

What problem does this address?

The block library PHP files are automatically synced to core with the package updates, so they should be made core-ready in Gutenberg.

One thing that's missing across the several files is @since notation on the functions. This issue tracks adding it in those files where needed.

[costdev]

For reference: Here is the PHP Documentation standards section relating to @since tags, when they should be added, and such.

[ramonjd]

I've added a few here: #52820

In no way exhaustive

[ndiego]

@ramonjd @tellthemachines is there still work to do on this for 6.3?

[tellthemachines]

It's unlikely we'll be doing much more here since RC3 is in a few days. Happy for it to be moved to 6.4!

[ramonjd]

is there still work to do on this for 6.3?

Thanks for the question. Yeah, it requires a bit of time to pick through. We might not have caught them all, but the major stuff has been done I think.

[gziolo]

Should we enforce usage of @since through the linter in these files? @anton-vlasenko is working on similar enhancements that will make these files compatible with WP Core.

[tellthemachines]

Yeah that would be great! We still have to retroactively add it to all the functions though 😅