Docblocks - Remove 'experimental' comments and other copy-edits

diff --git a/CRM/Utils/Hook.php b/CRM/Utils/Hook.php
index a4599f2ad468b6f244232de0120e5a261934463d..2477cb6325cb39d3d1a0f3effc0edc9d52c75397 100644 (file)
--- a/CRM/Utils/Hook.php
+++ b/CRM/Utils/Hook.php
@@ -677,7 +677,7 @@ abstract class CRM_Utils_Hook {
   }
 
   /**
-   * (Experimental) This hook is called when build the menu table.
+   * This hook is called when building the menu table.
    *
    * @param array $items
    *   List of records to include in menu table.
@@ -1176,7 +1176,7 @@ abstract class CRM_Utils_Hook {
   }
 
   /**
-   * (Experimental) Modify the list of template-types used for CiviMail composition.
+   * Modify the list of template-types used for CiviMail composition.
    *
    * @param array $types
    *   Sequentially indexed list of template types. Each type specifies:
@@ -1864,10 +1864,9 @@ abstract class CRM_Utils_Hook {
   }
 
   /**
-   * (EXPERIMENTAL) Scan extensions for a list of auto-registered interfaces.
+   * Scan extensions for a list of auto-registered interfaces.
    *
-   * This hook is currently experimental. It is a means to implementing `mixin/scan-classes@1`.
-   * If there are no major difficulties circa 5.55, then it can be marked stable.
+   * @see mixin/scan-classes@1
    *
    * @param string[] $classes
    *   List of classes which may be of interest to the class-scanner.
@@ -2670,7 +2669,7 @@ abstract class CRM_Utils_Hook {
   }
 
   /**
-   * EXPERIMENTAL: This hook allows one to register additional Angular modules
+   * Register Angular modules
    *
    * @param array $angularModules
    *   List of modules. Each module defines:

diff --git a/ext/afform/core/Civi/Afform/AngularDependencyMapper.php b/ext/afform/core/Civi/Afform/AngularDependencyMapper.php
index 67ac20c999be39ef8cb058564e6a375690073171..692ad8aebf89477df0971732defa875729a888ee 100644 (file)
--- a/ext/afform/core/Civi/Afform/AngularDependencyMapper.php
+++ b/ext/afform/core/Civi/Afform/AngularDependencyMapper.php
@@ -12,7 +12,7 @@
 namespace Civi\Afform;
 
 /**
- * Class AngularDependencyMapper
+ * Class used to calculate Afform Angular dependencies.
  * @package Civi\Afform
  */
 class AngularDependencyMapper {

diff --git a/ext/afform/core/Civi/Api4/Utils/AfformFormatTrait.php b/ext/afform/core/Civi/Api4/Utils/AfformFormatTrait.php
index 143c7edc0f1668a2efe22788f041dcc9c14de809..4f20d569d3bd6f0eb5d0a054571d640e46fe880d 100644 (file)
--- a/ext/afform/core/Civi/Api4/Utils/AfformFormatTrait.php
+++ b/ext/afform/core/Civi/Api4/Utils/AfformFormatTrait.php
@@ -14,9 +14,9 @@ trait AfformFormatTrait {
 
   /**
    * Controls the return format of the "layout" property
-   *  - html will return layout html as-is.
-   *  - shallow will convert most html to an array, but leave tag attributes and af-markup containers alone.
-   *  - deep will attempt to convert all html to an array, including tag attributes.
+   *  - "html" will return layout html as-is.
+   *  - "shallow" will convert most html to an array, but leave tag attributes and af-markup containers alone.
+   *  - "deep" will attempt to convert all html to an array, including tag attributes.
    *
    * @var string
    * @options html,shallow,deep
@@ -26,10 +26,10 @@ trait AfformFormatTrait {
   /**
    * Optionally manage whitespace for the "layout" property
    *
-   * This option will strip whitepace from the returned layout array for "get" actions,
-   * and will auto-indent the aff.html for "save" actions.
+   * This option will strip whitepace from the returned layout array for `get` actions,
+   * and will auto-indent the aff.html for `save` actions.
    *
-   * Note: currently this has no affect on "get" with "html" return format, which returns html as-is.
+   * Note: Has no effect on `get` with "html" return format, which returns html as-is.
    *
    * @var bool
    */