Normalize sort, URL structure

Author: kraftbj

.github/workflows/phpcs.yml

@@ -14,7 +14,7 @@ jobs:
     - name: Setup PHP
       uses: shivammathur/setup-php@v2
       with:
-        php-version: '8.1'
+        php-version: '8.4'
         tools: composer:v2
 
     - name: Install Dependencies

.github/workflows/verify-docs.yml

@@ -17,7 +17,7 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.1'
+          php-version: '8.4'
           extensions: mbstring, xml
           coverage: none
 

docs/bin/generate-parsed-md.php

@@ -365,6 +365,9 @@ private function format_doc_block( $doc ) {
 
 		$text = trim( $text );
 
+		// Normalize URL formatting - remove angle brackets
+		$text = preg_replace( '/<(https?:\/\/[^>]+)>/', '$1', $text );
+
 		// Convert @param, @return, @since, etc. into list items
 		$text = preg_replace(
 			'/^@(param|return|since|date|deprecated|var|package|type)\s+/m',
@@ -397,6 +400,9 @@ private function track_undocumented( $file, $type, $name ) {
 	 */
 	private function generate_index_files() {
 		foreach ( $this->files_by_directory as $dir => $files ) {
+			// Sort files for consistent order
+			sort( $files );
+
 			// Handle root directory differently
 			if ( '' === $dir || '.' === $dir ) {
 				$index_path = $this->output_dir . '/index.md';