Docblock summary is the first lines before a empty line, the description is the rest.

Author: dd32

lib/class-file-reflector.php

@@ -572,12 +572,17 @@ protected function convertPhpDocToArray( PhpDocNode $phpdoc_node ) {
 		}
 
 		// Split into summary and description
-		$text_lines = array_filter( explode( "\n", trim( $text_content ) ) );
+		$text_lines = explode( "\n", trim( $text_content ) );
 		if ( ! empty( $text_lines ) ) {
-			$docblock_data['summary'] = trim( $text_lines[0] );
-			if ( count( $text_lines ) > 1 ) {
-				$docblock_data['description'] = trim( implode( "\n", array_slice( $text_lines, 1 ) ) );
+			// Summary is the first lines before a blank line
+			$summary = '';
+			while ( ( $line = array_shift( $text_lines ) ) && $line ) {
+				$summary .= $line . ' ';
 			}
+			$docblock_data['summary'] = trim( $summary );
+
+			// The rest is the description.
+			$docblock_data['description'] = trim( implode( "\n", $text_lines ) );
 		}
 
 		// Extract tags

lib/runner.php

@@ -355,7 +355,7 @@ function export_docblock_from_data( $docblock_data ) {
 
 	// Format descriptions according to legacy expectations:
 	// - description (summary) should be plain text
-	// - long_description should be wrapped in HTML paragraphs with linebreaks removed
+	// - long_description should be wrapped in HTML paragraphs with linebreaks removed. TODO: Convert with markdown, ` and >.
 	$description = $docblock_data['summary'] ?? '';
 	$long_description = $docblock_data['description'] ?? '';