Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update banner & add support notice. #61

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Update banner & add support notice. #61

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
75536f9
Update banner & add support notice.
Jan 11, 2023
5eea55c
Address feedback.
Jan 17, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion app/3.0/docs/about_30.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Here's a quick sample of defining an element in Polymer 3.0:
</div>
</demo-tabs>

**Related product.** For new development, you should consider [LitElement](https://github.com/Polymer/lit-element/blob/master/README.md), a light, performant, next-generation base class for custom elements.
**Related product.** For new development, you should consider [Lit](https://lit.dev), a light, performant, next-generation library for web components.
{.alert .alert-tip}

## API changes
Expand Down
12 changes: 12 additions & 0 deletions app/3.0/docs/devguide/feature-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,18 @@ subtitle: Feature Overview
title: Polymer library
---

## Notice: Not under active development {#support-notice}

**The Polymer library is no longer under active development.** Only very select changes are being made to the code at this point, and newly-reported bugs are unlikely to be fixed unless they represent critical security issues.

**Polymer has been superseded by <a href="https://lit.dev">Lit</a>, a smaller, faster, next-generation web components library.** Thanks to the interoperability of web components, elements built with Polymer 3.0 and Lit can be mixed and matched in the same application. You can upgrade a Polymer project to Lit one element at a time.

* For information on upgrading, see <a href="https://lit.dev/articles/lit-for-polymer-users/">Lit for Polymer users</a>.

* For help with existing Polymer library apps or getting up to speed on Lit, we recommend joining the <a href="https://lit.dev/discord/">Lit Discord server</a>.

## Feature overview

The Polymer library provides a set of features for creating custom elements. These features are
designed to make it easier and faster to make custom elements that work like standard DOM elements.
Similar to standard DOM elements, Polymer elements can be:
Expand Down
28 changes: 2 additions & 26 deletions app/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -234,8 +234,8 @@ <h1>Polymer Library</h1>
</p>
<p>
<strong>For new projects, we recommend starting with our next-generation web components
library, <a href="https://lit-element.polymer-project.org">LitElement</a>.</strong>
LitElement is a smaller, lighter successor to the Polymer library.
library, <a href="https://lit.dev">Lit</a>.</strong>
Litis a smaller, lighter successor to the Polymer library.
</p>
<p>
For existing Polymer apps, we recommend upgrading to version 3.0 of the Polymer library.
Expand All @@ -249,30 +249,6 @@ <h1>Polymer Library</h1>
</div>
</section>

<section class="page-index-summit dark gradient-dark">
<div>
<h2>Welcome to the future...</h2>
<p>Starting a new project? Try our next-gen products:</p>
<div class="section-columns">
<div>
<h2 class="underline">LitElement</h2>
<p>An ultra-light, highly performant custom element base class with a simple but expressive API.</p>
<a href="https://lit-element.polymer-project.org" class="blue-button nocap flex">LitElement</a>
</div>
<div>
<h2 class="underline">lit-html</h2>
<p>An efficient, expressive, extensible HTML templating library for JavaScript.</p>
<a href="https://lit-html.polymer-project.org/" class="blue-button flex">lit-html</a>
</div>
<div>
<h2 class="underline">Material Web Components</h2>
<p>Pixel-perfect realizations of Google's Material Design spec that work anywhere on the web.</p>
<a href="https://github.com/material-components/material-components-web-components" class="blue-button flex">Material Web Components</a>
</div>
</div>
</div>
</section>

<section class="grey gradient-light page-index-logos">
<div>
<h2>Browser Compatibility</h2>
Expand Down
4 changes: 3 additions & 1 deletion templates/base-devguide.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,9 @@ <h1>{{{title}}}</h1>
<img src="/images/alerts/upgrade.svg" height="36px">
<p>
<strong>
The Polymer library is in maintenance mode. For new development, we recommend <a href="https://lit.dev">Lit</a>.
The Polymer library is no longer under active development.
We recommend moving to <a href="https://lit.dev">Lit</a>.
For more information, see the <a href="/3.0/docs/devguide/feature-overview#support-notice">support notice.</a>
</strong>
</p>
</div>
Expand Down