diff --git a/.pullapprove.yml b/.pullapprove.yml index f0b8cc3ff6..34dd0cba79 100644 --- a/.pullapprove.yml +++ b/.pullapprove.yml @@ -1121,6 +1121,7 @@ groups: 'docs/SAVED_REPLIES.md', 'docs/TOOLS.md', 'docs/TRIAGE_AND_LABELS.md', + 'docs/images/**', 'goldens/*', 'modules/*', 'packages/*', diff --git a/README.md b/README.md index 09e107ea12..cef5f16b88 100644 --- a/README.md +++ b/README.md @@ -1,27 +1,151 @@ -[![CircleCI](https://circleci.com/gh/angular/angular/tree/master.svg?style=shield)](https://circleci.com/gh/angular/workflows/angular/tree/master) -[![Discord](https://img.shields.io/discord/463752820026376202.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/angular) -[![Join the chat at https://gitter.im/angular/angular](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/angular/angular?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) -[![npm version](https://badge.fury.io/js/%40angular%2Fcore.svg)](https://www.npmjs.com/@angular/core) +

Angular - One framework. Mobile & desktop.

+

+ angular-logo +
+ Angular is a development platform for building mobile and desktop web applications +
using Typescript/JavaScript and other languages.
+
+

-# Angular +

+ www.angular.io +
+

-Angular is a development platform for building mobile and desktop web applications using TypeScript/JavaScript and other languages. +

+ Contributing Guidelines + · + Submit an Issue + · + Blog +
+
+

+ +

+ + CI status +   + + Angular on npm +   + + Discord conversation + +

+ +
+ +## Documentation + +Get started with Angular, learn the fundamentals and explore advanced topics on our documentation website. + +- [Getting Started][quickstart] +- [Architecture][architecture] +- [Components and Templates][componentstemplates] +- [Forms][forms] +- [API][api] + +### Advanced + +- [Angular Elements][angularelements] +- [Server Side Rendering][ssr] +- [Schematics][schematics] +- [Lazy Loading][lazyloading] + +## Development Setup + +### Prerequisites + +- Install [Node.js] which includes [Node Package Manager][npm] + +### Setting Up a Project + +Intall the Angular CLI globally: + +``` +npm install -g @angular/cli +``` + +Create workspace: + +``` +ng new [PROJECT NAME] +``` + +Run the application: + +``` +cd [PROJECT NAME] +ng serve +``` ## Quickstart [Get started in 5 minutes][quickstart]. +## Ecosystem + +

+ angular ecosystem logos +

+ +- [Angular Command Line (CLI)][cli] +- [Angular Material][angularmaterial] + ## Changelog [Learn about the latest improvements][changelog]. -## Want to help? +## Upgrading -Want to file a bug, contribute some code, or improve documentation? Excellent! Read up on our -guidelines for [contributing][contributing] and then check out one of our issues in the [hotlist: community-help](https://github.com/angular/angular/labels/hotlist%3A%20community-help). +Check out our [upgrade guide](https://update.angular.io/) to find out the best way to upgrade your project. -[contributing]: https://github.com/angular/angular/blob/master/CONTRIBUTING.md +## Contributing + +### Contributing Guidelines + +Read through our [contributing guidelines][contributing] to learn about our submission process, coding rules and more. + +### Want to Help? + +Want to file a bug, contribute some code, or improve documentation? Excellent! Read up on our guidelines for [contributing][contributing] and then check out one of our issues in the [hotlist: community-help](https://github.com/angular/angular/labels/hotlist%3A%20community-help). + +### Code of Conduct + +Help us keep Angular open and inclusive. Please read and follow our [Code of Conduct][codeofconduct]. + +## Community + +Join the conversation and help the community. + +- [Twitter][twitter] +- [Gitter][gitter] +- Find a Local [Meetup][meetup] + +[![Love Angular badge](https://img.shields.io/badge/angular-love-blue?logo=angular&angular=love)](https://www.github.com/angular/angular) + +**Love Angular? Give our repo a star :star: :arrow_up:.** + +[contributing]: CONTRIBUTING.md [quickstart]: https://angular.io/start -[changelog]: https://github.com/angular/angular/blob/master/CHANGELOG.md +[changelog]: CHANGELOG.md [ng]: https://angular.io +[documentation]: https://angular.io/docs +[angularmaterial]: https://material.angular.io/ +[cli]: https://cli.angular.io/ +[architecture]: https://angular.io/guide/architecture +[componentstemplates]: https://angular.io/guide/displaying-data +[forms]: https://angular.io/guide/forms-overview +[api]: https://angular.io/api +[angularelements]: https://angular.io/guide/elements +[ssr]: https://angular.io/guide/universal +[schematics]: https://angular.io/guide/schematics +[lazyloading]: https://angular.io/guide/lazy-loading-ngmodules +[node.js]: https://nodejs.org/ +[npm]: https://www.npmjs.com/get-npm +[codeofconduct]: CODE_OF_CONDUCT.md +[twitter]: https://www.twitter.com/angular +[gitter]: https://gitter.im/angular/angular +[meetup]: https://www.meetup.com/find/?keywords=angular" diff --git a/docs/images/angular-ecosystem-logos.png b/docs/images/angular-ecosystem-logos.png new file mode 100644 index 0000000000..f1f311b3d9 Binary files /dev/null and b/docs/images/angular-ecosystem-logos.png differ