Skip to content

Commit b46b116

Browse files
authored
Merge pull request #1069 from IgnaceMaes/polaris-page
docs: extend the Polaris edition page
2 parents 84599c7 + c50fe9f commit b46b116

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

app/templates/editions/polaris.hbs

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,37 @@
1111
a new <a href="https://github.com/embroider-build/embroider">build pipeline</a> that hooks into the tool of your choice (webpack, rollup, etc), and a new <a href="https://github.com/NullVoxPopuli/ember-resources">reactivity system</a>.
1212
</p>
1313

14+
<h2>The pillars of Polaris</h2>
15+
<p>The Polaris edition of Ember is built upon these core concepts.</p>
16+
17+
<h3>1. First-class TypeScript Support</h3>
18+
<p>Ember has embraced TypeScript as a first-class citizen next to JavaScript. In practice this means you can build apps using TypeScript without having to worry about incompatibility with external type definitions of Ember itself. As of version 5.1, Ember ships with built-in stable types. Read all about it and how to get started <a href="https://blog.emberjs.com/stable-typescript-types-in-ember-5-1">in the Stable TypeScript Types announcement post.</a> Glint, the TypeScript-powered tooling for Glimmer templates, also shipped as a stable release after two years of public preview. For more information, read the <a href="https://blog.emberjs.com/glint-1-0-released">Glint release blog post</a>.</p>
19+
20+
<h3>2. Template tag components</h3>
21+
<p>
22+
The template tag syntax is the new authoring format for components in Ember. It addresses some long-standing developer experience challenges with the current format, and incorporates community feedback. Improvements include:
23+
<ul>
24+
<li>
25+
explicit imports prevent naming conflicts
26+
</li>
27+
<li>
28+
the new ability to introduce locally-scoped code
29+
</li>
30+
<li>
31+
improved interoperability with third-party JavaScript libraries in the template
32+
</li>
33+
<li>
34+
aligning test syntax with app syntax
35+
</li>
36+
</ul>
37+
It also helps unlock the road to new capabilities such as code splitting in the future. See the <a href="https://github.com/ember-template-imports/ember-template-imports">ember-template-imports repository </a> to get started today!</p>
38+
39+
<h3>3. Embroider build system</h3>
40+
<p><a href="https://github.com/embroider-build/embroider">Embroider</a> is the next-generation build system for Ember apps. The goal is to compile Ember apps into spec-compliant, modern Javascript. This allows the integration with all the build tooling improvements seen in the wider JavaScript ecosystem.</p>
41+
42+
<h3>4. Reactivity improvements</h3>
43+
<p>The Octane edition saw the introduction of auto-tracking which simplified the previous reactivity system, and made it more performant. Polaris introduces the concept of <a href="https://github.com/NullVoxPopuli/ember-resources">resources</a>. This pattern is a general concept that extends beyond Ember or any framework. To learn about the framework-agnostic approach to universal reactivity, check out the <a href="https://www.starbeamjs.com/">Starbeam Project</a>.</p>
44+
1445
<h2>How you can help</h2>
1546
<p>
1647
Shipping an edition is a collaborative effort that involves the entire Ember community.

0 commit comments

Comments
 (0)