docs: normalize phpdoc since tags across admin and health modules (#228)

## Summary
- convert remaining @Version annotations to @SInCE across general,
process, multisite admin, and Site Health helpers
- add missing @SInCE tags to the sanitization helpers and Site Health
software checks so every function documents its introduction

## Testing
- vendor/bin/phpcs *(fails: Referenced sniff "PHPCompatibilityWP" does
not exist.)*
- vendor/bin/phpstan analyse --memory-limit=1G *(fails: At least one
path must be specified to analyse.)*
- vendor/bin/phpunit *(fails: Missing /tmp/wordpress-tests-lib setup)*

------
https://chatgpt.com/codex/tasks/task_b_6904628a05848321994e7e8b82310c1a

Author: javiercasares

wpvulnerability-admin.php

@@ -422,8 +422,16 @@ function wpvulnerability_render_admin_tab_logs() {
 					<?php endif; ?>
 			</div>
 	</section>
-	<?php
+<?php
 }
+
+/**
+ * Outputs the Tools tab contents.
+ *
+ * @since 4.1.2
+ *
+ * @return void
+ */
 function wpvulnerability_render_admin_tab_tools() {
 						$tools_action = add_query_arg(
 							array(
@@ -813,10 +821,17 @@ function wpvulnerability_render_admin_tab_about() {
 								?>
 							</div>
 						</section>
-						<?php
-					}
-					
-					function wpvulnerability_create_admin_page() {
+<?php
+}
+
+/**
+ * Renders the plugin settings page in the WordPress admin area.
+ *
+ * @since 2.0.0
+ *
+ * @return void
+ */
+function wpvulnerability_create_admin_page() {
 
 						$wpvulnerability_settings = get_option( 'wpvulnerability-config' );
 						?>
@@ -905,10 +920,17 @@ class="wpvulnerability-tab-panel is-active"
 								</div>
 							</div>
 						</div>
-						<?php
-					}
-					
-					function wpvulnerability_admin_menu() {
+<?php
+}
+
+/**
+ * Registers the WPVulnerability settings page within the Settings menu.
+ *
+ * @since 2.0.0
+ *
+ * @return void
+ */
+function wpvulnerability_admin_menu() {
 
 						// Adds a submenu page under the Settings menu.
 						add_submenu_page(

wpvulnerability-adminms.php

@@ -4,15 +4,15 @@
  *
  * @package WPVulnerability
  *
- * @version 2.0.0
+ * @since 2.0.0
  */
 
 defined( 'ABSPATH' ) || die( 'No script kiddies please!' );
 
 /**
  * Load the settings to be available always.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @return array|false An array containing the WPVulnerability settings if they exist, or false if they don't.
  */
@@ -22,7 +22,7 @@
 /**
  * Enqueues the WPVulnerability admin CSS file on WPVulnerability admin pages.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @return void
  */
@@ -803,8 +803,16 @@ function wpvulnerability_render_network_admin_tab_logs() {
 					<?php endif; ?>
 			</div>
 	</section>
-	<?php
+<?php
 }
+
+/**
+ * Outputs the Tools tab contents for the multisite settings screen.
+ *
+ * @since 4.1.2
+ *
+ * @return void
+ */
 function wpvulnerability_render_network_admin_tab_tools() {
 	$tools_action = add_query_arg(
 		array(
@@ -1894,6 +1902,8 @@ function wpvulnerability_admin_dashboard() {
 /**
  * Strictly sanitizes the main configuration (emails and periods).
  *
+ * @since 2.0.0
+ *
  * @param array $input Input values.
  * @return array Sanitized values.
  */
@@ -1985,6 +1995,8 @@ function wpvulnerability_sanitize_config( $input ) {
 /**
  * Sanitizes the messages generated by the plugin (simple messages).
  *
+ * @since 2.0.0
+ *
  * @param array $input Input values.
  * @return array Sanitized values.
  */
@@ -2001,6 +2013,8 @@ function wpvulnerability_sanitize_messages( $input ) {
 /**
  * Strictly sanitizes the analysis options (booleans).
  *
+ * @since 3.3.0
+ *
  * @param array $input Input values.
  * @return array Sanitized values.
  */

wpvulnerability-general.php

@@ -4,7 +4,7 @@
  *
  * @package WPVulnerability
  *
- * @version 2.0.0
+ * @since 2.0.0
  */
 
 defined( 'ABSPATH' ) || die( 'No script kiddies please!' );
@@ -613,7 +613,7 @@ function wpvulnerability_normalize_notify_settings( $notify ) {
  * This function removes any leading or trailing whitespace from the version string
  * and strips out any non-alphanumeric characters except for hyphens, underscores, and dots.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @param string $version The version string to sanitize.
  *
@@ -1022,6 +1022,13 @@ function wpvulnerability_detect_memcached() {
 	return wpvulnerability_sanitize_and_validate_version( $version );
 }
 
+/**
+ * Detects the installed PHP version using available runtime information.
+ *
+ * @since 2.0.0
+ *
+ * @return string|null The detected PHP version in N.n or N.n.n format, or null if unavailable.
+ */
 function wpvulnerability_detect_php() {
 	// Initialize the version variable.
 	$version = null;
@@ -1460,7 +1467,7 @@ function wpvulnerability_detect_sqlserver() {
  * This function takes a comparison operator in string format and returns
  * its corresponding HTML entity for better readability in web contexts.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @param string $op The operator string to prettify.
  *
@@ -1490,7 +1497,7 @@ function wpvulnerability_pretty_operator( $op ) {
  * This function takes a severity string and returns a human-readable
  * severity level, localized for translation.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @param string $severity The severity string to prettify.
  *
@@ -1519,7 +1526,7 @@ function wpvulnerability_severity( $severity ) {
  * This function fetches vulnerability information based on the provided type and slug.
  * It supports caching to minimize API requests and improve performance.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @param string $type  The type of vulnerability. Can be 'core', 'plugin', or 'theme'.
  * @param string $slug  The slug of the plugin or theme. For core vulnerabilities, it is the version string.

wpvulnerability-process.php

@@ -4,15 +4,15 @@
  *
  * @package WPVulnerability
  *
- * @version 2.0.0
+ * @since 2.0.0
  */
 
 defined( 'ABSPATH' ) || die( 'No script kiddies please!' );
 
 /**
  * Convert vulnerabilities into pretty HTML
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @param string $type Type: core, plugin, theme, php, apache, nginx, mariadb, mysql, imagemagick, curl.
  * @param array  $vulnerabilities Vulnerability data.
@@ -126,7 +126,7 @@ function wpvulnerability_html( $type, $vulnerabilities ) {
 /**
  * Convert vulnerabilities into HTML format.
  *
- * @version 3.5.0
+ * @since 3.5.0
  *
  * @param string $type Type of software (php, apache, nginx, mariadb, mysql, imagemagick, curl).
  * @return string|false The HTML output if vulnerabilities were found, false otherwise.
@@ -179,7 +179,7 @@ function wpvulnerability_html_software( $type ) {
 /**
  * Convert plugin vulnerabilities into HTML format.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @return string|false The HTML output if plugin vulnerabilities were found, false otherwise.
  */
@@ -207,7 +207,7 @@ function wpvulnerability_html_plugins() {
 /**
  * Convert plugin vulnerabilities into list format.
  *
- * @version 2.2.0
+ * @since 2.2.0
  *
  * @return string|false The HTML output if plugin vulnerabilities were found, false otherwise.
  */
@@ -238,7 +238,7 @@ function wpvulnerability_list_plugins() {
 /**
  * Convert theme vulnerabilities into HTML format.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @return string|false The HTML output if theme vulnerabilities were found, false otherwise.
  */
@@ -268,7 +268,7 @@ function wpvulnerability_html_themes() {
 /**
  * Convert theme vulnerabilities into list format.
  *
- * @version 2.2.0
+ * @since 2.2.0
  *
  * @return string|false The HTML output if theme vulnerabilities were found, false otherwise.
  */
@@ -299,7 +299,7 @@ function wpvulnerability_list_themes() {
 /**
  * Convert core vulnerabilities into HTML format.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @return string|false The HTML output if core vulnerabilities were found, false otherwise.
  */

wpvulnerability-sitehealth.php

@@ -4,15 +4,15 @@
  *
  * @package WPVulnerability
  *
- * @version 2.0.0
+ * @since 2.0.0
  */
 
 defined( 'ABSPATH' ) || die( 'No script kiddies please!' );
 
 /**
  * Tests for vulnerabilities in installed plugins.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @return array Returns an array with the results of the vulnerability test.
  */
@@ -64,7 +64,7 @@ function wpvulnerability_test_plugins() {
 /**
  * Tests for vulnerabilities in installed themes.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @return array Returns an array with the results of the vulnerability test.
  */
@@ -116,7 +116,7 @@ function wpvulnerability_test_themes() {
 /**
  * Tests for vulnerabilities in core.
  *
- * @version 2.0.0
+ * @since 2.0.0
  *
  * @return array Returns an array with the results of the vulnerability test.
  */
@@ -168,7 +168,7 @@ function wpvulnerability_test_core() {
 /**
  * Tests for vulnerabilities in a specified software component.
  *
- * @version 3.5.0
+ * @since 3.5.0
  *
  * @param string $software The type of software to test (php, apache, nginx, mariadb, mysql).
  * @return array Returns an array with the results of the vulnerability test.
@@ -254,6 +254,8 @@ function wpvulnerability_test_software( $software ) {
 /**
  * Tests for vulnerabilities in MySQL.
  *
+ * @since 3.5.0
+ *
  * @return array Returns an array with the results of the vulnerability test.
  */
 function wpvulnerability_test_mysql() {
@@ -263,6 +265,8 @@ function wpvulnerability_test_mysql() {
 /**
  * Tests for vulnerabilities in MariaDB.
  *
+ * @since 3.5.0
+ *
  * @return array Returns an array with the results of the vulnerability test.
  */
 function wpvulnerability_test_mariadb() {
@@ -272,6 +276,8 @@ function wpvulnerability_test_mariadb() {
 /**
  * Tests for vulnerabilities in Apache.
  *
+ * @since 3.5.0
+ *
  * @return array Returns an array with the results of the vulnerability test.
  */
 function wpvulnerability_test_apache() {
@@ -281,6 +287,8 @@ function wpvulnerability_test_apache() {
 /**
  * Tests for vulnerabilities in Nginx.
  *
+ * @since 3.5.0
+ *
  * @return array Returns an array with the results of the vulnerability test.
  */
 function wpvulnerability_test_nginx() {
@@ -290,6 +298,8 @@ function wpvulnerability_test_nginx() {
 /**
  * Tests for vulnerabilities in PHP.
  *
+ * @since 3.5.0
+ *
  * @return array Returns an array with the results of the vulnerability test.
  */
 function wpvulnerability_test_php() {
@@ -299,6 +309,8 @@ function wpvulnerability_test_php() {
 /**
  * Tests for vulnerabilities in ImageMagick.
  *
+ * @since 3.5.0
+ *
  * @return array Returns an array with the results of the vulnerability test.
  */
 function wpvulnerability_test_imagemagick() {
@@ -308,6 +320,8 @@ function wpvulnerability_test_imagemagick() {
 /**
  * Tests for vulnerabilities in curl.
  *
+ * @since 3.5.0
+ *
  * @return array Returns an array with the results of the vulnerability test.
  */
 function wpvulnerability_test_curl() {
@@ -317,6 +331,8 @@ function wpvulnerability_test_curl() {
 /**
  * Tests for vulnerabilities in memcached.
  *
+ * @since 3.5.0
+ *
  * @return array Returns an array with the results of the vulnerability test.
  */
 function wpvulnerability_test_memcached() {
@@ -326,6 +342,8 @@ function wpvulnerability_test_memcached() {
 /**
  * Tests for vulnerabilities in Redis.
  *
+ * @since 3.5.0
+ *
  * @return array Returns an array with the results of the vulnerability test.
  */
 function wpvulnerability_test_redis() {
@@ -335,6 +353,8 @@ function wpvulnerability_test_redis() {
 /**
  * Tests for vulnerabilities in SQLite.
  *
+ * @since 3.5.0
+ *
  * @return array Returns an array with the results of the vulnerability test.
  */
 function wpvulnerability_test_sqlite() {