diff --git a/core/includes/install.core.inc b/core/includes/install.core.inc
index 00c301eb99b3a45c4ac9a8e84fe57236587e50c2..8275f3e5b009a681a42a915ceea60a8993332805 100644
--- a/core/includes/install.core.inc
+++ b/core/includes/install.core.inc
@@ -1161,15 +1161,13 @@ function install_select_profile(&$install_state) {
* Determines the installation profile to use in the installer.
*
* A profile will be selected in the following order of conditions:
- *
- * 1. Only one profile is available.
- * 2. A specific profile name is requested in installation parameters:
- * - for interactive installations via request query parameters.
- * - for non-interactive installations via install_drupal() settings.
- * 3. A discovered profile that is a distribution.
- * If multiple profiles are distributions, then the first discovered profile
- * will be selected.
- * 4. Only one visible profile is available.
+ * - Only one profile is available.
+ * - A specific profile name is requested in installation parameters:
+ * - For interactive installations via request query parameters.
+ * - For non-interactive installations via install_drupal() settings.
+ * - A discovered profile that is a distribution. If multiple profiles are
+ * distributions, then the first discovered profile will be selected.
+ * - Only one visible profile is available.
*
* @param array $install_state
* The current installer state, containing a 'profiles' key, which is an
diff --git a/core/lib/Drupal/Core/Asset/AssetResolverInterface.php b/core/lib/Drupal/Core/Asset/AssetResolverInterface.php
index 6857c87ffc01b8fddd0a72b58cb91bdb5e96ccd7..c912d7663c4968638546362f9744906405bef72f 100644
--- a/core/lib/Drupal/Core/Asset/AssetResolverInterface.php
+++ b/core/lib/Drupal/Core/Asset/AssetResolverInterface.php
@@ -26,11 +26,11 @@ interface AssetResolverInterface {
*
* It returns the CSS assets in order, according to the SMACSS categories
* specified in the assets' weights:
- * 1. CSS_BASE
- * 2. CSS_LAYOUT
- * 3. CSS_COMPONENT
- * 4. CSS_STATE
- * 5. CSS_THEME
+ * - CSS_BASE
+ * - CSS_LAYOUT
+ * - CSS_COMPONENT
+ * - CSS_STATE
+ * - CSS_THEME
* @see https://www.drupal.org/node/1887918#separate-concerns
* This ensures proper cascading of styles so themes can easily override
* module styles through CSS selectors.
diff --git a/core/lib/Drupal/Core/Cache/CacheContexts.php b/core/lib/Drupal/Core/Cache/CacheContexts.php
index 5de6527dbebc629e5cd242ce4e1b1aac8ff65c44..bede04d59423138743692a8f4d3fca023d1537f5 100644
--- a/core/lib/Drupal/Core/Cache/CacheContexts.php
+++ b/core/lib/Drupal/Core/Cache/CacheContexts.php
@@ -204,9 +204,9 @@ protected function getService($context_id) {
* @return array
* An array with the parsed results, with each result being an array
* containing:
- * 1. the cache context ID
- * 2. the associated parameter (for a calculated cache context), or NULL if
- * there is no parameter.
+ * - The cache context ID.
+ * - The associated parameter (for a calculated cache context), or NULL if
+ * there is no parameter.
*/
public static function parseTokens(array $context_tokens) {
$contexts_with_parameters = [];
diff --git a/core/lib/Drupal/Core/Menu/MenuLinkTreeElement.php b/core/lib/Drupal/Core/Menu/MenuLinkTreeElement.php
index ed79fd988758c578ced74b8a231e705560f6fd08..a52b6c2f858b506161cf4293c74329af7842d2b9 100644
--- a/core/lib/Drupal/Core/Menu/MenuLinkTreeElement.php
+++ b/core/lib/Drupal/Core/Menu/MenuLinkTreeElement.php
@@ -17,13 +17,13 @@
* plus what their parent is. But they don't know where exactly in a menu link
* tree they live.
* - Instances of this class are complimentary to those objects, they know:
- * 1. all additional metadata from {menu_tree}, which contains "materialized"
- * metadata about a menu link tree, such as whether a link in the tree has
- * visible children and the depth relative to the root;
- * 2. plus all additional metadata that's adjusted for the current tree query,
- * such as whether the link is in the active trail, whether the link is
- * accessible for the current user, and the link's children (which are only
- * loaded if the link was marked as "expanded" by the query).
+ * - All additional metadata from {menu_tree}, which contains "materialized"
+ * metadata about a menu link tree, such as whether a link in the tree has
+ * visible children and the depth relative to the root.
+ * - Plus all additional metadata that's adjusted for the current tree query,
+ * such as whether the link is in the active trail, whether the link is
+ * accessible for the current user, and the link's children (which are only
+ * loaded if the link was marked as "expanded" by the query).
*
* @see \Drupal\Core\Menu\MenuTreeStorage::loadTreeData()
*/
diff --git a/core/lib/Drupal/Core/Render/BareHtmlPageRendererInterface.php b/core/lib/Drupal/Core/Render/BareHtmlPageRendererInterface.php
index da15eea3e9a8d5c9d39ed6bfa8b5f25fd694a8b4..1b4a5f538558ebdb6bce16e9c822cb27b76abaea 100644
--- a/core/lib/Drupal/Core/Render/BareHtmlPageRendererInterface.php
+++ b/core/lib/Drupal/Core/Render/BareHtmlPageRendererInterface.php
@@ -38,8 +38,9 @@
* in a limited environment).
*
* Currently, there are two types of bare pages available:
- * 1. install (hook_preprocess_install_page(), install-page.html.twig)
- * 2. maintenance (hook_preprocess_maintenance_page(), maintenance-page.html.twig)
+ * - Install (hook_preprocess_install_page(), install-page.html.twig).
+ * - Maintenance (hook_preprocess_maintenance_page(),
+ * maintenance-page.html.twig).
*
* @see \Drupal\Core\Render\MainContent\HtmlRenderer
*/
diff --git a/core/modules/filter/src/FilterProcessResult.php b/core/modules/filter/src/FilterProcessResult.php
index 67e49faf51c3c6d93373f382dccde11b0ccd5521..80ad9e5a0b111035b015d9d24a1bf722cf37b14f 100644
--- a/core/modules/filter/src/FilterProcessResult.php
+++ b/core/modules/filter/src/FilterProcessResult.php
@@ -17,14 +17,14 @@
* The typical use case for a text filter plugin's processing method is to just
* apply some filtering to the given text, but for more advanced use cases,
* it may be necessary to also:
- * 1. declare asset libraries to be loaded;
- * 2. declare cache tags that the filtered text depends upon, so when either of
+ * - Declare asset libraries to be loaded.
+ * - Declare cache tags that the filtered text depends upon, so when either of
* those cache tags is invalidated, the filtered text should also be
- * invalidated;
- * 3. declare cache context to vary by, e.g. 'language' to do language-specific
- * filtering.
- * 4. declare a maximum age for the filtered text
- * 5. apply uncacheable filtering, for example because it differs per user.
+ * invalidated.
+ * - Declare cache context to vary by, e.g. 'language' to do language-specific
+ * filtering.
+ * - Declare a maximum age for the filtered text.
+ * - Apply uncacheable filtering, for example because it differs per user.
*
* In case a filter needs one or more of these advanced use cases, it can use
* the additional methods available.
diff --git a/core/modules/language/src/Tests/LanguageUILanguageNegotiationTest.php b/core/modules/language/src/Tests/LanguageUILanguageNegotiationTest.php
index 99d4778be6e7af19bb7f4ee28e3c8b40eef6fe87..44bfdabb7c1e9fc98a0f57269922af3420c40a8b 100644
--- a/core/modules/language/src/Tests/LanguageUILanguageNegotiationTest.php
+++ b/core/modules/language/src/Tests/LanguageUILanguageNegotiationTest.php
@@ -23,30 +23,22 @@
use Drupal\block\Entity\Block;
/**
- * Tests UI language switching.
+ * Tests the language UI for language switching.
*
- * 1. URL (PATH) > DEFAULT
- * UI Language base on URL prefix, browser language preference has no
- * influence:
- * admin/config
- * UI in site default language
- * zh-hans/admin/config
- * UI in Chinese
- * blah-blah/admin/config
- * 404
- * 2. URL (PATH) > BROWSER > DEFAULT
- * admin/config
- * UI in user's browser language preference if the site has that
- * language added, if not, the default language
- * zh-hans/admin/config
- * UI in Chinese
- * blah-blah/admin/config
- * 404
- * 3. URL (DOMAIN) > DEFAULT
- * http://example.com/admin/config
- * UI language in site default
- * http://example.cn/admin/config
- * UI language in Chinese
+ * The uses cases that get tested, are:
+ * - URL (path) > default: Test that the URL prefix setting gets precedence over
+ * the default language. The browser language preference does not have any
+ * influence.
+ * - URL (path) > browser > default: Test that the URL prefix setting gets
+ * precedence over the browser language preference, which in turn gets
+ * precedence over the default language.
+ * - URL (domain) > default: Tests that the URL domain setting gets precedence
+ * over the default language.
+ *
+ * The paths that are used for each of these, are:
+ * - admin/config: Tests the UI using the precedence rules.
+ * - zh-hans/admin/config: Tests the UI in Chinese.
+ * - blah-blah/admin/config: Tests the 404 page.
*
* @group language
*/
diff --git a/core/modules/system/theme.api.php b/core/modules/system/theme.api.php
index 2d383826d3836b5f8dbfc991df5c81d0f6a8a1d5..fcbacf1b122b7313fadadd2df6b8d924732b0606 100644
--- a/core/modules/system/theme.api.php
+++ b/core/modules/system/theme.api.php
@@ -164,27 +164,27 @@
*
* @section assets Assets
* We can distinguish between three types of assets:
- * 1. unconditional page-level assets (loaded on all pages where the theme is in
- * use): these are defined in the theme's *.info.yml file.
- * 2. conditional page-level assets (loaded on all pages where the theme is in
- * use and a certain condition is met): these are attached in
- * hook_page_attachments_alter(), e.g.:
- * @code
- * function THEME_page_attachments_alter(array &$page) {
- * if ($some_condition) {
- * $page['#attached']['library'][] = 'mytheme/something';
- * }
- * }
- * @endcode
- * 3. template-specific assets (loaded on all pages where a specific template is
- * in use): these can be added by in preprocessing functions, using @code
- * $variables['#attached'] @endcode, e.g.:
- * @code
- * function THEME_preprocess_menu_local_action(array &$variables) {
- * // We require Modernizr's touch test for button styling.
- * $variables['#attached']['library'][] = 'core/modernizr';
- * }
- * @endcode
+ * - Unconditional page-level assets (loaded on all pages where the theme is in
+ * use): these are defined in the theme's *.info.yml file.
+ * - Conditional page-level assets (loaded on all pages where the theme is in
+ * use and a certain condition is met): these are attached in
+ * hook_page_attachments_alter(), e.g.:
+ * @code
+ * function THEME_page_attachments_alter(array &$page) {
+ * if ($some_condition) {
+ * $page['#attached']['library'][] = 'mytheme/something';
+ * }
+ * }
+ * @endcode
+ * - Template-specific assets (loaded on all pages where a specific template is
+ * in use): these can be added by in preprocessing functions, using @code
+ * $variables['#attached'] @endcode, e.g.:
+ * @code
+ * function THEME_preprocess_menu_local_action(array &$variables) {
+ * // We require Modernizr's touch test for button styling.
+ * $variables['#attached']['library'][] = 'core/modernizr';
+ * }
+ * @endcode
*
* @see hooks
* @see callbacks
diff --git a/core/tests/Drupal/Tests/Core/Access/AccessResultTest.php b/core/tests/Drupal/Tests/Core/Access/AccessResultTest.php
index c549a3c373149c6d9aefd65f5798411ddacd4f76..43ae63a49ff3da60f6dbcfba39e1b296e5bd2b92 100644
--- a/core/tests/Drupal/Tests/Core/Access/AccessResultTest.php
+++ b/core/tests/Drupal/Tests/Core/Access/AccessResultTest.php
@@ -473,15 +473,15 @@ public function testInheritCacheability() {
* every single bit of cacheability metadata, which would lead to a mind-
* boggling number of permutations, in this test, we only consider the
* permutations of all pairs of the following set:
- * 1. Allowed, implements CDI, is cacheable
- * 2. Allowed, implements CDI, is not cacheable
- * 3. Allowed, does not implement CDI (hence not cacheable)
- * 4. Forbidden, implements CDI, is cacheable
- * 5. Forbidden, implements CDI, is not cacheable
- * 6. Forbidden, does not implement CDI (hence not cacheable)
- * 7. Neutral, implements CDI, is cacheable
- * 8. Neutral, implements CDI, is not cacheable
- * 9. Neutral, does not implement CDI (hence not cacheable)
+ * - Allowed, implements CDI and is cacheable.
+ * - Allowed, implements CDI and is not cacheable.
+ * - Allowed, does not implement CDI (hence not cacheable).
+ * - Forbidden, implements CDI and is cacheable.
+ * - Forbidden, implements CDI and is not cacheable.
+ * - Forbidden, does not implement CDI (hence not cacheable).
+ * - Neutral, implements CDI and is cacheable.
+ * - Neutral, implements CDI and is not cacheable.
+ * - Neutral, does not implement CDI (hence not cacheable).
*
* (Where "CDI" is CacheableDependencyInterface.)
*
@@ -490,15 +490,15 @@ public function testInheritCacheability() {
* 144 permutations, all of which are tested.
*
* There are two "contagious" patterns:
- * 1. Any operation with a forbidden access result yields a forbidden result.
- * This therefore also applies to the cacheability metadata associated with
- * a forbidden result.
- * This is the case for items 4, 5 and 6 in the set above.
- * 2. Any operation yields an access result object that is of the same class
- * (implementation) as the first operand. This is because operations are
- * invoked on the first operand. Therefore, if the first implementation
- * does not implement CacheableDependencyInterface, then the result won't
- * either. This is the case for items 3, 6 and 9 in the set above.
+ * - Any operation with a forbidden access result yields a forbidden result.
+ * This therefore also applies to the cacheability metadata associated with
+ * a forbidden result. This is the case for bullets 4, 5 and 6 in the set
+ * above.
+ * - Any operation yields an access result object that is of the same class
+ * (implementation) as the first operand. This is because operations are
+ * invoked on the first operand. Therefore, if the first implementation
+ * does not implement CacheableDependencyInterface, then the result won't
+ * either. This is the case for bullets 3, 6 and 9 in the set above.
*/
public function andOrCacheabilityPropagationProvider() {
// ct: cacheable=true, cf: cacheable=false, un: uncacheable.
diff --git a/core/tests/Drupal/Tests/Core/Render/RendererPostRenderCacheTest.php b/core/tests/Drupal/Tests/Core/Render/RendererPostRenderCacheTest.php
index 9cddf0740754a1923afab81958f7a6e8a13ab601..99a639e11d7d911fbeb78055989b6d6c6a2124bc 100644
--- a/core/tests/Drupal/Tests/Core/Render/RendererPostRenderCacheTest.php
+++ b/core/tests/Drupal/Tests/Core/Render/RendererPostRenderCacheTest.php
@@ -32,9 +32,9 @@ protected function setUp() {
* Generates an element with a #post_render_cache callback.
*
* @return array
- * An array containing:
- * 1. a render array containing a #post_render_cache callback
- * 2. the context used for that #post_render_cache callback.
+ * An array containing:
+ * - A render array containing a #post_render_cache callback.
+ * - The context used for that #post_render_cache callback.
*/
protected function generatePostRenderCacheElement() {
$context = ['foo' => $this->randomContextValue()];