build: refactor location of best-practices.md

alan-agius4 · web-flow · commit 07a51872d5b2 · 2025-10-24T18:45:32.000+02:00
This commit moves the best-practices.md file from adev/src/context to packages/core/resources. The BUILD.bazel files and other configuration files have been updated to reflect this change.
diff --git a/.ng-dev/google-sync-config.json b/.ng-dev/google-sync-config.json
@@ -3,7 +3,7 @@
   "separateFilePatterns": ["packages/core/primitives/**"],
   "alwaysExternalFilePatterns": [
     "packages/*",
-    "packages/bazel/**",
+    "packages/core/resources/**",
     "packages/compiler-cli/linker/**",
     "packages/compiler-cli/src/ngtsc/sourcemaps/**",
     "packages/compiler-cli/src/ngtsc/testing/**",
diff --git a/adev/src/assets/BUILD.bazel b/adev/src/assets/BUILD.bazel
@@ -133,6 +133,7 @@ copy_to_directory(
     name = "context",
     srcs = [
         "//adev/src/context",
+        "//packages/core/resources:best-practices.md",
     ],
     replace_prefixes = {
         "**/": "",
diff --git a/adev/src/content/ai/BUILD.bazel b/adev/src/content/ai/BUILD.bazel
@@ -9,6 +9,7 @@ generate_guides(
     data = [
         "//adev/src/assets/images:what_is_angular.svg",
         "//adev/src/context",
+        "//packages/core/resources:best-practices.md",
     ],
     visibility = ["//adev:__subpackages__"],
 )
diff --git a/adev/src/content/ai/develop-with-ai.md b/adev/src/content/ai/develop-with-ai.md
@@ -10,9 +10,9 @@ NOTE: These files will be updated on a regular basis staying up to date with Ang
 
 Here is a set of instructions to help LLMs generate correct code that follows Angular best practices. This file can be included as system instructions to your AI tooling or included along with your prompt as context.
 
-<docs-code language="md" path="adev/src/context/best-practices.md" class="compact"/>
+<docs-code language="md" path="packages/core/resources/best-practices.md" class="compact"/>
 
-<a download href="/assets/context/best-practices.md" target="_blank">Click here to download the best-practices.md file.</a> 
+<a download href="/assets/context/best-practices.md" target="_blank">Click here to download the best-practices.md file.</a>
 
 ## Rules Files
 Several editors, such as <a href="https://studio.firebase.google.com?utm_source=adev&utm_medium=website&utm_campaign=BUILD_WITH_AI_ANGULAR&utm_term=angular_devrel&utm_content=build_with_ai_angular_firebase_studio">Firebase Studio</a> have rules files useful for providing critical context to LLMs.
@@ -35,7 +35,7 @@ The Angular CLI includes an experimental [Model Context Protocol (MCP) server](h
 `llms.txt` is a proposed standard for websites designed to help LLMs better understand and process their content. The Angular team has developed two versions of this file to help LLMs and tools that use LLMs for code generation to create better modern Angular code.
 
 
-* <a href="/llms.txt" target="_blank">llms.txt</a> - an index file providing links to key files and resources. 
+* <a href="/llms.txt" target="_blank">llms.txt</a> - an index file providing links to key files and resources.
 * <a href="/context/llm-files/llms-full.txt" target="_blank">llms-full.txt</a> - a more robust compiled set of resources describing how Angular works and how to build Angular applications.
 
 Be sure [to check out the overview page](/ai) for more information on how to integrate AI into your Angular applications.
diff --git a/packages/core/BUILD.bazel b/packages/core/BUILD.bazel
@@ -58,6 +58,7 @@ ng_package(
     srcs = [
         "package.json",
         ":event_dispatch_contract_binary",
+        "//packages/core/resources",
     ],
     nested_packages = [
         "//packages/core/schematics:npm_package",
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -40,6 +40,12 @@
     "migrations": "./schematics/migrations.json",
     "packageGroup": "NG_UPDATE_PACKAGE_GROUP"
   },
+  "angular": {
+    "bestPractices": {
+      "format": "markdown",
+      "path": "./resources/best-practices.md"
+    }
+  },
   "schematics": "./schematics/collection.json",
   "sideEffects": false
 }
diff --git a/packages/core/resources/BUILD.bazel b/packages/core/resources/BUILD.bazel
@@ -0,0 +1,15 @@
+exports_files(
+    srcs = ["best-practices.md"],
+    visibility = [
+        "//adev/src/assets:__pkg__",
+        "//adev/src/content/ai:__pkg__",
+    ],
+)
+
+filegroup(
+    name = "resources",
+    srcs = ["best-practices.md"],
+    visibility = [
+        "//packages/core:__pkg__",
+    ],
+)
diff --git a/packages/core/resources/best-practices.md b/packages/core/resources/best-practices.md

Original file line number	Diff line number	Diff line change
`@@ -9,6 +9,7 @@ generate_guides(`
`9`	`9`	`data = [`
`10`	`10`	`"//adev/src/assets/images:what_is_angular.svg",`
`11`	`11`	`"//adev/src/context",`
	`12`	`+ "//packages/core/resources:best-practices.md",`
`12`	`13`	`],`
`13`	`14`	`visibility = ["//adev:__subpackages__"],`
`14`	`15`	`)`