Improve docblocks for clarity

Co-authored-by: Weston Ruter <[email protected]>

Author: ShyamGadde

plugins/optimization-detective/storage/class-od-url-metrics-post-type.php

@@ -200,7 +200,7 @@ static function ( $url_metric_data ) use ( $trigger_error ) {
 	}
 
 	/**
-	 * Updates the URL Metrics Post Type with new URL Metrics.
+	 * Inserts or updates the od_url_metrics post with a provided collection of URL Metrics.
 	 *
 	 * This method updates an existing URL Metrics post or creates a new one if it doesn't exist.
 	 *

plugins/optimization-detective/tests/class-optimization-detective-test-helpers.php

@@ -169,7 +169,7 @@ function ( array $element ) use ( $params ): array {
 	/**
 	 * Stores URL Metric by merging it with the other URL Metrics which share the same normalized query vars.
 	 *
-	 * @param non-empty-string $slug Slug (hash of normalized query vars).
+	 * @param non-empty-string $slug           Slug (hash of normalized query vars).
 	 * @param OD_URL_Metric    $new_url_metric New URL Metric.
 	 * @return positive-int|WP_Error Post ID on success, or WP_Error on failure.
 	 */