diff --git a/aio/content/guide/glossary.md b/aio/content/guide/glossary.md index ae5f9ecc79..d0a6f39968 100644 --- a/aio/content/guide/glossary.md +++ b/aio/content/guide/glossary.md @@ -622,6 +622,19 @@ A class which is preceded by the `@Pipe{}` decorator and which defines a functio To learn more, see [Pipes](guide/pipes). +{@a platform} + +## platform + +In Angular terminology, a platform is the context in which an Angular application runs. +The most common platform for Angular applications is a web browser, but it can also be an operating system for a mobile device, or a web server. + +Support for the various Angular run-time platforms is provided by the `@angular/platform-*` packages. These packages allow applications that make use of `@angular/core` and `@angular/common` to execute in different environments by providing implementation for gathering user input and rendering UIs for the given platform. Isolating platform-specific functionality allows the developer to make platform-independent use of the rest of the framework. + +* When running in a web browser, [`BrowserModule`](api/platform-browser/BrowserModule) is imported from the `platform-browser` package, and supports services that simplify security and event processing, and allows applications to access browser-specific features, such as interpreting keyboard input and controlling the title of the document being displayed. All applications running in the browser use the same platform service. + +* When [server-side rendering](#server-side-rendering) (SSR) is used, the [`platform-server`](api/platform-server) package provides web server implementations of the `DOM`, `XMLHttpRequest`, and other low-level features that don't rely on a browser. + {@a polyfill} ## polyfill diff --git a/packages/platform-browser/PACKAGE.md b/packages/platform-browser/PACKAGE.md index 6891d8a1a5..d4914c01b4 100644 --- a/packages/platform-browser/PACKAGE.md +++ b/packages/platform-browser/PACKAGE.md @@ -1,7 +1,7 @@ -Supports delivery of Angular apps on different supported browsers. +Supports execution of Angular apps on different supported browsers. -The `BrowserModule` is included by default in any app created through the CLI, -and it re-exports the `CommonModule` and `ApplicationModule` exports, +The `BrowserModule` is included by default in any app created through the CLI, +and it re-exports the `CommonModule` and `ApplicationModule` exports, making basic Angular functionality available to the app. For more information, see [Browser Support](guide/browser-support). \ No newline at end of file diff --git a/packages/platform-server/PACKAGE.md b/packages/platform-server/PACKAGE.md new file mode 100644 index 0000000000..d8ade466ee --- /dev/null +++ b/packages/platform-server/PACKAGE.md @@ -0,0 +1,3 @@ +Supports delivery of Angular apps on a server, for use with [server-side rendering](guide/glossary#server-side-rendering) (SSR). + +For more information, see [Server-side Rendering: An intro to Angular Universal](guide/universal). \ No newline at end of file