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.

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

[all] Expand jsdoc documentation #1883

Open
aomarks opened this issue May 12, 2021 · 1 comment
Open

[all] Expand jsdoc documentation #1883

aomarks opened this issue May 12, 2021 · 1 comment
Assignees
Milestone

Comments

@aomarks
Copy link
Member

aomarks commented May 12, 2021

The jsdoc documentation for all the core libraries are currently very lacking, as can be seen by browsing through https://lit.dev/docs/api/LitElement/ and related pages.

We should sweep through every API and a whole bunch of missing documentation.

@AndrewJakubowicz
Copy link
Contributor

AndrewJakubowicz commented Jan 21, 2022

Note the list below was generated from the lit.dev API docs. There may be some duplication.

Usage: Check off audited identifiers. If a PR improved the documentation please link to the PR.

Publicly generated JSDoc symbols to audit/improve (top level):

LitElement

  • LitElement - /packages/lit-element/src/lit-element.ts#L86
  • RenderOptions - /packages/lit-html/src/lit-html.ts#L375

ReactiveElement

Templates

Styles

Decorators

Directives

Custom Directives

Static HTML

  • html - /packages/lit-html/src/static.ts#L133
  • literal - /packages/lit-html/src/static.ts#L55
  • svg - /packages/lit-html/src/static.ts#L141
  • unsafeStatic - /packages/lit-html/src/static.ts#L26
  • withStatic - /packages/lit-html/src/static.ts#L72

Controllers

Misc

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: In Progress
Development

No branches or pull requests

4 participants