From 75536f9bb8043ab0d8e2c8f52bf83b586afd55f7 Mon Sep 17 00:00:00 2001 From: Arthur Evans Date: Wed, 11 Jan 2023 15:40:42 -0800 Subject: [PATCH 1/2] Update banner & add support notice. --- app/3.0/docs/devguide/feature-overview.md | 14 ++++++++++++++ templates/base-devguide.html | 3 ++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/app/3.0/docs/devguide/feature-overview.md b/app/3.0/docs/devguide/feature-overview.md index babe30c2..9cb83149 100644 --- a/app/3.0/docs/devguide/feature-overview.md +++ b/app/3.0/docs/devguide/feature-overview.md @@ -3,6 +3,20 @@ 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. + +* If you're starting a new project, or doing significant work on an existing one, we recommend using the Lit library, a 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 Lit for Polymer users. + +* For help with existing Polymer library apps or getting up to speed on Lit, we recommend joining the Lit Discord server. + +## 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: diff --git a/templates/base-devguide.html b/templates/base-devguide.html index 5e6cd925..bcb269de 100644 --- a/templates/base-devguide.html +++ b/templates/base-devguide.html @@ -59,7 +59,8 @@

{{{title}}}

- The Polymer library is in maintenance mode. For new development, we recommend Lit. + The Polymer library is no longer under active development. + For more information, see the support notice.

From 5eea55cad1169e083ffd50470f065c122f2d8fbc Mon Sep 17 00:00:00 2001 From: Arthur Evans Date: Tue, 17 Jan 2023 11:14:44 -0800 Subject: [PATCH 2/2] Address feedback. --- app/3.0/docs/about_30.md | 2 +- app/3.0/docs/devguide/feature-overview.md | 4 +--- app/index.html | 28 ++--------------------- templates/base-devguide.html | 1 + 4 files changed, 5 insertions(+), 30 deletions(-) diff --git a/app/3.0/docs/about_30.md b/app/3.0/docs/about_30.md index 2d31a647..83426c25 100644 --- a/app/3.0/docs/about_30.md +++ b/app/3.0/docs/about_30.md @@ -29,7 +29,7 @@ Here's a quick sample of defining an element in Polymer 3.0: -**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 diff --git a/app/3.0/docs/devguide/feature-overview.md b/app/3.0/docs/devguide/feature-overview.md index 9cb83149..7ad0b446 100644 --- a/app/3.0/docs/devguide/feature-overview.md +++ b/app/3.0/docs/devguide/feature-overview.md @@ -7,9 +7,7 @@ title: Polymer library **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. -* If you're starting a new project, or doing significant work on an existing one, we recommend using the Lit library, a 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. +**Polymer has been superseded by Lit, 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 Lit for Polymer users. diff --git a/app/index.html b/app/index.html index 0587e86c..f09774d0 100644 --- a/app/index.html +++ b/app/index.html @@ -234,8 +234,8 @@

Polymer Library

For new projects, we recommend starting with our next-generation web components - library, LitElement. - LitElement is a smaller, lighter successor to the Polymer library. + library, Lit. + Litis a smaller, lighter successor to the Polymer library.

For existing Polymer apps, we recommend upgrading to version 3.0 of the Polymer library. @@ -249,30 +249,6 @@

Polymer Library

-
-
-

Welcome to the future...

-

Starting a new project? Try our next-gen products:

-
-
-

LitElement

-

An ultra-light, highly performant custom element base class with a simple but expressive API.

- LitElement -
-
-

lit-html

-

An efficient, expressive, extensible HTML templating library for JavaScript.

- lit-html -
-
-

Material Web Components

-

Pixel-perfect realizations of Google's Material Design spec that work anywhere on the web.

- Material Web Components -
-
-
-
-

Browser Compatibility

diff --git a/templates/base-devguide.html b/templates/base-devguide.html index bcb269de..28b43996 100644 --- a/templates/base-devguide.html +++ b/templates/base-devguide.html @@ -60,6 +60,7 @@

{{{title}}}

The Polymer library is no longer under active development. + We recommend moving to Lit. For more information, see the support notice.