Skip to content
This repository has been archived by the owner on Dec 4, 2017. It is now read-only.

Clarify dependencies & polyfills #2659

Open
code-tree opened this issue Oct 23, 2016 · 0 comments
Open

Clarify dependencies & polyfills #2659

code-tree opened this issue Oct 23, 2016 · 0 comments

Comments

@code-tree
Copy link

Problem
It is not clear what dependencies Angular requires, and why.

Some dependencies are vaguely mentioned in the Docs' Quickstart, and while the page on Browser Support helps, it also adds some confusion. It is not clear what are actually dependencies and what are just polyfills. Nor is it clear which ones are really required.

Solution
State clearly what is required, and why.

AFAIK: Almost all Angular's dependencies are really polyfills, as most are being proposed to be added to browsers in future. The only real dependency seems to be rxjs.

As for the polyfills, core-js is recommended for ES6, but really it covers some of ES7 and reflect-metadata. So if people include core-js then they don't need reflect-metadata (#1748). It is also not clear what other (if any) ES7 features are required.

Clarifying this kind of stuff would be very helpful, and preferably on the one page. I had to flick between the Quickstart and Browser Support pages until I finally figured out what I actually needed to include.

thanks

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant