Correct the documented return type for WP_Block_Parser::render()

[johnbillion]

What?

This fixes an inline documentation error for the WP_Block_Parser::render() method.

Why?

This method returns an array of arrays, not an array of WP_Block_Parser_Block instances. The proceed() method always casts the WP_Block_Parser_Block instance to an array.

• gutenberg/packages/block-serialization-default-parser/parser.php

  Line 303 in 5de7f23

  $this->output[] = (array) $this->freeform(

• gutenberg/packages/block-serialization-default-parser/parser.php

  Line 312 in 5de7f23

  $this->output[] = (array) new WP_Block_Parser_Block( $block_name, $attrs, array(), '', array() );

Testing Instructions

1. Call the parse_blocks() function with some post content that contains blocks
2. Observe that an array of arrays is returned

[dmsnell]

Nice catch @johnbillion - though I believe that the PR description and title (and also in the commit message) don't reflect the changes here. This is the parse() method on the WP_Block_parser class. I'm guessing it started as one thing and then turned into another? Would be great if we updated the title to reflect the fix so we don't confuse ourselves in the future when reading the history.

[johnbillion]

Cheers Dennis, fixed.

[dmsnell]

Oops, looks like the fixes didn't make it into the merge as it still shows in the commit message the wrong method name. Oh well 🤷‍♂️