docs(docs-infra): Refactors tutorial generation and updates ng-container docs

Updates the `ng-container` documentation page to use the correct `angular-html` code format and removes an unused CLI documentation file.

Author: SkyZeroZx

adev/scripts/update-cross-repo-docs/README.md

@@ -12,4 +12,4 @@ Updates the Angular CDK API JSON files in `adev/src/content/cdk`, used for the [
 
 ## CLI Help Pages
 
-Updates the Angular CLI help JSON files in `adev/src/content/cli/help`, used for the [angular.dev CLI](https://angular.dev/cli) pages.
+Updates the Angular CLI help JSON files in `adev/src/content/cli`, used for the [angular.dev CLI](https://angular.dev/cli) pages.

adev/scripts/update-cross-repo-docs/index.mjs

@@ -26,7 +26,7 @@ async function main() {
   await updateAssets({
     repo: 'angular/cli-builds',
     assetsPath: 'help',
-    destPath: join(import.meta.dirname, '../../src/content/cli/help'),
+    destPath: join(import.meta.dirname, '../../src/content/cli'),
   });
 
   console.log('\n-----------------------------------------------');

adev/shared-docs/pipeline/tutorials/playground_index.mts

@@ -57,7 +57,7 @@ async function generatePlaygroundFiles(
     );
     writeFileSync(
       join(outputDir, path, 'source-code.json'),
-      JSON.stringify(await generateSourceCode(config, itemFiles)),
+      JSON.stringify(await generateSourceCode(itemFiles)),
     );
   }
 

adev/shared-docs/pipeline/tutorials/source-code.mts

@@ -7,14 +7,11 @@
  */
 
 import {FileSystemTree} from '@webcontainer/api';
-import {FileAndContentRecord, TutorialConfig} from '../../interfaces/index';
+import {FileAndContentRecord} from '../../interfaces/index';
 import {getFileSystemTree} from './webcontainers.mjs';
 
 /** Generate the source-code.json content for a provided tutorial config. */
-export async function generateSourceCode(
-  config: TutorialConfig,
-  files: FileAndContentRecord,
-): Promise<FileSystemTree> {
+export async function generateSourceCode(files: FileAndContentRecord): Promise<FileSystemTree> {
   // TODO(josephperrott): figure out if filtering is needed for this.
   const allFiles = Object.keys(files);
   return getFileSystemTree(allFiles, files);

adev/shared-docs/pipeline/tutorials/tutorial_index.mts

@@ -54,7 +54,7 @@ async function generateTutorialFiles(tutorialDir: string, commonDir: string, out
   );
   writeFileSync(
     join(outputDir, 'source-code.json'),
-    JSON.stringify(await generateSourceCode(introConfig, introFiles)),
+    JSON.stringify(await generateSourceCode(introFiles)),
   );
 
   // For each tutorial step, generate the metadata and source-code files.
@@ -75,7 +75,7 @@ async function generateTutorialFiles(tutorialDir: string, commonDir: string, out
     );
     writeFileSync(
       join(outputDir, path, 'source-code.json'),
-      JSON.stringify(await generateSourceCode(config, itemFiles)),
+      JSON.stringify(await generateSourceCode(itemFiles)),
     );
   }
 

adev/src/assets/BUILD.bazel

@@ -12,7 +12,7 @@ copy_to_directory(
         "//adev/src/content/best-practices",
         "//adev/src/content/best-practices/runtime-performance",
         "//adev/src/content/cdk:cdk_docs",
-        "//adev/src/content/cli/help:cli_docs",
+        "//adev/src/content/cli:cli_docs",
         "//adev/src/content/ecosystem",
         "//adev/src/content/ecosystem/rxjs-interop",
         "//adev/src/content/ecosystem/service-workers",
@@ -94,7 +94,7 @@ copy_to_directory(
         "//tools/manual_api_docs/elements:elements_docs",
     ],
     replace_prefixes = {
-        "adev/src/content/cli/help/cli_docs_html": "cli/",
+        "adev/src/content/cli/cli_docs_html": "cli/",
         "adev/src/content/aria/aria_docs_html": "api/",
         "adev/src/content/cdk/cdk_docs_html": "api/",
         "adev/src/content": "",

adev/src/content/cli/BUILD.bazel

@@ -1,14 +1,23 @@
+load("//adev/shared-docs/pipeline/api-gen/rendering:render_api_to_html.bzl", "render_api_to_html")
+
 package(default_visibility = ["//visibility:public"])
 
+exports_files(["_build-info.json"])
+
 filegroup(
     name = "cli",
     srcs = glob(
-        ["**"],
+        ["*.json"],
         exclude = [
-            "BUILD.bazel",
+            # Exclude _build-info.json as it is not a help entry.
+            "_build-info.json",
         ],
-    ) + [
-        "//adev/src/content/cli/help",
-        "//adev/src/content/cli/help:_build-info.json",
+    ),
+)
+
+render_api_to_html(
+    name = "cli_docs",
+    srcs = [
+        ":cli",
     ],
 )