From 14e363278d34638cc8fb14dddf08dc1bc117c780 Mon Sep 17 00:00:00 2001
From: Alan Agius <17563226+alan-agius4@users.noreply.github.com>
Date: Wed, 15 Oct 2025 09:56:40 +0000
Subject: [PATCH 1/2] docs(@angular/build): add descriptions for application
 builder options

Adds more detailed descriptions for the `assets` and `outputHashing` options in the `@angular/build:application` builder's schema. This improves clarity for users configuring these options.

Closes #31477
---
 packages/angular/build/src/builders/application/schema.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/angular/build/src/builders/application/schema.json b/packages/angular/build/src/builders/application/schema.json
index 3ee8699e097f..c0a0f98313aa 100644
--- a/packages/angular/build/src/builders/application/schema.json
+++ b/packages/angular/build/src/builders/application/schema.json
@@ -6,7 +6,7 @@
   "properties": {
     "assets": {
       "type": "array",
-      "description": "List of static application assets.",
+      "description": "Define the assets to be copied to the output directory. These assets are copied as-is without any further processing or hashing.",
       "default": [],
       "items": {
         "$ref": "#/definitions/assetPattern"
@@ -441,7 +441,7 @@
     },
     "outputHashing": {
       "type": "string",
-      "description": "Define the output filename cache-busting hashing mode.",
+      "description": "Define the output filename cache-busting hashing mode.\n\n- `none`: No hashing.\n- `all`: Hash for all output bundles. \n- `media`: Hash for all output media (e.g., images, fonts, etc. that are referenced in CSS files).\n- `bundles`: Hash for output of lazy and main bundles.",
       "default": "none",
       "enum": ["none", "all", "media", "bundles"]
     },

From 25eb9cffbc3259d20848dadacd5cb1bc9cd271a1 Mon Sep 17 00:00:00 2001
From: Alan Agius <17563226+alan-agius4@users.noreply.github.com>
Date: Wed, 15 Oct 2025 09:59:16 +0000
Subject: [PATCH 2/2] docs(@angular-devkit/build-angular): add descriptions for
 browser builder options

Adds more detailed descriptions for the `assets` and `outputHashing` options in the `@angular-devkit/build-angular:browser` builder's schema. This improves clarity for users configuring these options.
---
 .../build_angular/src/builders/browser/schema.json            | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/angular_devkit/build_angular/src/builders/browser/schema.json b/packages/angular_devkit/build_angular/src/builders/browser/schema.json
index f8170c3969da..301eeafcc4f1 100644
--- a/packages/angular_devkit/build_angular/src/builders/browser/schema.json
+++ b/packages/angular_devkit/build_angular/src/builders/browser/schema.json
@@ -6,7 +6,7 @@
   "properties": {
     "assets": {
       "type": "array",
-      "description": "List of static application assets.",
+      "description": "Define the assets to be copied to the output directory. These assets are copied as-is without any further processing or hashing.",
       "default": [],
       "items": {
         "$ref": "#/definitions/assetPattern"
@@ -319,7 +319,7 @@
     },
     "outputHashing": {
       "type": "string",
-      "description": "Define the output filename cache-busting hashing mode.",
+      "description": "Define the output filename cache-busting hashing mode.\n\n- `none`: No hashing.\n- `all`: Hash for all output bundles. \n- `media`: Hash for all output media (e.g., images, fonts, etc. that are referenced in CSS files).\n- `bundles`: Hash for output of lazy and main bundles.",
       "default": "none",
       "enum": ["none", "all", "media", "bundles"]
     },