As a developer I would like documentation on how to create a Web Component

[thescientist13]

Type of Change

• New Feature Request
• Documentation
• Future Spec
• Improvement / Suggestion
• Bug
• Other (please clarify below)

Summary

Some documentation on how to create a component. Topics to cover (link out where appropriate to keep it DRY):

• event handling (Custom Events)
• data binding
• props / state
• attributes / properties
• Shadow DOM
• custom elements
• sub classing (LitElement, HTMLElement)
• how to design a good component API

Use Case

Developers looking to create their first web component.

Code Sample

N / A

Pros / Cons

No cons, other than the usual risk with documentation that it can get out dated easily.

[thescientist13]

Links / References:

• https://twitter.com/justinfagnani/status/1035279790767452160
• [docs] best practices lit/lit-element#37
• https://43081j.com/2018/08/future-of-polymer

[thescientist13]

Provide documentation here?
lit/lit-element#37

[thescientist13]

@hutchgrant
You may be interested in this issue.

[hutchgrant]

Added a basic hello world style guide. The topics you want covered should perhaps be on separate pages with separate examples.