Docs roadmap

[manucorporat]

• Docs

  • DEEP DIVE (docs from my talk Stencil compiler: https://github.com/manucorporat/stencil-framework-to-compiler )

  • Assets management

    • resourcesUrl
    • how to use them
    • unpkg/distribution

  • document multiple stylesheets and @Prop() mode

  • Best practices guides

    • How to structure your projects
    • Build performance, how to speed up your builds
    • Vanilla data-flow best practices
    • Runtime performance, what's cheap/expensive?
    • Shadow-dom guide, differences between browsers, when/why to use it? When not
    • Distribution workflow
      • Firebase
      • GitHub docs
      • Your own server

• Better debugging

  • Do not bundle in dev mode
  • research preserveModules in rollup
  • More docs/guides about debugging with stencil
  • Debugging tests (attach vscode debugger)

• Third party libraries

  • Better error messages
  • More docs
    • FAQ: Most common mistakes.
  • Rollup fixes?

• Multiple exports in the same .tsx

  • Better errors messages
  • Better static analysis
    • Detect unexported types used in the public API (props, events, methods)
  • Relax rules to allow to export pure types (interfaces and aliases),

[arjunyel]

Section on using commonjs libs in stencil would be awesome

[shreeshbhat]

It is time taking to find relevant content faster within docs. A search option at the top would be great.