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 @@
-[](https://circleci.com/gh/angular/workflows/angular/tree/master)
-[](https://discord.gg/angular)
-[](https://gitter.im/angular/angular?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
-[](https://www.npmjs.com/@angular/core)
+
Angular - One framework. Mobile & desktop.
+
+
+
+ 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
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## 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 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]
+
+[](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