docs: initial commit of Angular Package Format documentation (angular#43987)

alxhub · alxhub · commit 509b14536abe · 2021-11-01T18:24:21.000-07:00
This commit adds the Angular Package Format to AIO. Previously this document was updated and versioned in Google Docs. The document is also updated for the Angular Package Format version 13. PR Close angular#43987
diff --git a/.pullapprove.yml b/.pullapprove.yml
@@ -1091,7 +1091,8 @@ groups:
         contains_any_globs(files, [
           'aio/content/guide/creating-libraries.md',
           'aio/content/guide/libraries.md',
-          'aio/content/guide/using-libraries.md'
+          'aio/content/guide/using-libraries.md',
+          'aio/content/guide/angular-package-format.md'
           ])
     reviewers:
       users:
@@ -1223,6 +1224,7 @@ groups:
         contains_any_globs(files.exclude("goldens/public-api/manage.js"), [
           'goldens/public-api/**',
           'docs/NAMING.md',
+          'aio/content/guide/angular-package-format.md',
           'aio/content/errors/*.md',
           'aio/content/guide/glossary.md',
           'aio/content/guide/styleguide.md',
diff --git a/aio/content/guide/angular-package-format.md b/aio/content/guide/angular-package-format.md
diff --git a/aio/content/guide/glossary.md b/aio/content/guide/glossary.md
@@ -34,6 +34,14 @@ An Angular [component](#component) packaged as a [custom element](#custom-elemen
 
 Learn more in [Angular Elements Overview](guide/elements).
 
+{@a apf}
+
+## Angular package format (APF)
+
+An Angular specific specification for layout of npm packages that is used by all first-party Angular packages, and most third-party Angular libraries.
+
+Learn more in the [Angular Package Format specification](guide/angular-package-format).
+
 {@a annotation}
 
 ## annotation
diff --git a/aio/content/navigation.json b/aio/content/navigation.json
@@ -740,6 +740,11 @@
               "url": "guide/creating-libraries",
               "title": "Creating Libraries",
               "tooltip": "Extend Angular by creating, publishing, and using your own libraries."
+            },
+            {
+              "url": "guide/angular-package-format",
+              "title": "Angular Package Format",
+              "tooltip": "Information about the Angular Package Format."
             }
           ]
         }
@@ -1232,4 +1237,4 @@
       ]
     }
   ]
-}
+}
diff --git a/aio/firebase.json b/aio/firebase.json
@@ -188,6 +188,9 @@
       // Use discoverable link for Angular DevTools and redirect to the guide page
       {"type": 301, "source": "/devtools", "destination": "/guide/devtools"},
 
+      // Use discoverable link for Angular Package Format and redirect to the guide page
+      {"type": 301, "source": "/apf", "destination": "/guide/angular-package-format"},
+
       // Temporarily serve the guide at `/devtools` as well as `/guide/devtools` until users have
       // their SW updated to a version that knows about the `/devtools` redirect.
       {"type": 302, "source": "/generated/docs/devtools.json", "destination": "/generated/docs/guide/devtools.json"}
diff --git a/aio/tests/deployment/shared/URLS_TO_REDIRECT.txt b/aio/tests/deployment/shared/URLS_TO_REDIRECT.txt
@@ -1,3 +1,4 @@
+/apf --> /guide/angular-package-format
 /api/animate/AnimationBuilder --> /api/animations/AnimationBuilder
 /api/animate/CssAnimationBuilder --> /api/animations/CssAnimationBuilder
 /api/api/core/ElementRef --> /api/core/ElementRef

Original file line number	Diff line number	Diff line change
`@@ -740,6 +740,11 @@`
`740`	`740`	`"url": "guide/creating-libraries",`
`741`	`741`	`"title": "Creating Libraries",`
`742`	`742`	`"tooltip": "Extend Angular by creating, publishing, and using your own libraries."`
	`743`	`+ },`
	`744`	`+ {`
	`745`	`+ "url": "guide/angular-package-format",`
	`746`	`+ "title": "Angular Package Format",`
	`747`	`+ "tooltip": "Information about the Angular Package Format."`
`743`	`748`	`}`
`744`	`749`	`]`
`745`	`750`	`}`
`@@ -1232,4 +1237,4 @@`
`1232`	`1237`	`]`
`1233`	`1238`	`}`
`1234`	`1239`	`]`
`1235`		`-}`
	`1240`	`+}`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+/apf --> /guide/angular-package-format`
`1`	`2`	`/api/animate/AnimationBuilder --> /api/animations/AnimationBuilder`
`2`	`3`	`/api/animate/CssAnimationBuilder --> /api/animations/CssAnimationBuilder`
`3`	`4`	`/api/api/core/ElementRef --> /api/core/ElementRef`