LitElement conversion part 4: API docs

[web-padawan]

Document API

• Add JSDoc comment for the custom element definition:

  • Use markdown for a short description. Avoid large snippets

  • Use @attr JSDoc annotation for documenting state attributes

  • Use @csspart JSDoc annotation for documenting Shadow Parts

  • Use @slot JSDoc annotation for documenting slots

  • Use @event JSDoc annotation for documenting events

• Add JSDoc comments for all the public properties

Serve docs

• Copy index.html file from skeleton, update title

• Update files to analyze in npm run analyze script

• Start es-dev-server to browse API docs and demo:

$ npm start

Create dist

• Copy rollup.config.js from skeleton (used to build CDN demo)

• Run the npm script to test how the built demo works locally:

$ npm run dist && npm run serve:dist

[web-padawan]

Done by #141