Organize guides

[idoros]

The current state of the guides section is out of date and requires a re-thinking and work.

• [x] list sections in guides full coverage of stylable features and capabilities
• [x] decide on writing style, tone, and structure
• handbook
  • [x] introduction
  • [x] classes
  • [x] namespacing
  • [x] custom state
  • [x] runtime
  • [x] import class
  • [x] extend
  • [ ] vars (build time & custom properties)
  • [ ] templating
  • [ ] assets
  • [ ] 3rd party
  • [ ] style patterns (incorporate patterns into handbook)
  • [ ] build
  • [ ] optimizations
  • [ ] serve side render
  • [ ] publish

[idoros]

Handbook - planned chapters

vars

• build vars
• custom properties

templating

• formatter
• mixin

assets

• url() resolution
• ~ prefix

3rd party

• import native CSS
• interface for non Stylable stylesheets
• definitely styled

style patterns

• utility classes
• reset
• project commons
  • design system / tokens
• style variants
• theme
  • @st-scope

build

• CLI
• webpack, rollup...
• stylable config
• depth
• validation
  • build diagnostics
  • d.ts validations

optimization

server side rendering

publishing

• lib vs app