vaadin/flow-and-components-documentation

Add disclaimer to polymer-template docs that it is not recommended anymore

pleku opened this issue · 1 comments

pleku commented

Each polymer specific feature should have a disclaimer in the beginning that
"Usage of polymer based templates is deprecated since Vaadin 18 and we recommend using Lit based templates instead."

For each chapter it could also be clarified how the same thing can be achieved with the recommended way now, like:

  • event handler -> component API & dom events via element API
  • template model -> component API / properties via element API

Also it might be better to highlight that this feature is about "Using templates for UI and Java for UI logic" or something similar, as the topic "Using template API" does not convey why one should read this documentation.

pleku commented

This is done now with #1353