diff --git a/README.md b/README.md index 6b6e341be..4e80059c8 100644 --- a/README.md +++ b/README.md @@ -126,6 +126,8 @@ The easiest way to get setup is add `babel-preset-solid` to your .babelrc, or ba "presets": ["solid"] ``` +Remember there are significant differences between how Solid's JSX works and a library like React. Refer to [JSX Rendering](../master/documentation/rendering.md) for more information. + Alternatively in non-compiled environments you can use Tagged Template Literals [Lit DOM Expressions](https://github.com/ryansolid/lit-dom-expressions) or even HyperScript with [Hyper DOM Expressions](https://github.com/ryansolid/hyper-dom-expressions). For convenience Solid exports interfaces to runtimes for these as: diff --git a/documentation/rendering.md b/documentation/rendering.md index 486caa636..962fea2ff 100644 --- a/documentation/rendering.md +++ b/documentation/rendering.md @@ -32,7 +32,7 @@ If you need to use non-lowercase or hyphenated event names use the events bindin ## Control Flow -While you could use a map function for loops and raw ternary operators of conditionals they aren't optimized. While perhaps not as big of a deal in the VDOM since Solid is designed to not execute all the code from top down repeatedly we rely on techniques like isolated contexts and memoization. This is complicated and requires special methods. Current 'For', 'Show', 'Switch/Match', 'Suspense', and 'Portal' are supported. +While you could use a map function for loops and raw ternary operators of conditionals they aren't optimized. While perhaps not as big of a deal in the VDOM since Solid is designed to not execute all the code from top down repeatedly we rely on techniques like isolated contexts and memoization. This is complicated and requires special methods. Currently 'For', 'Show', 'Switch/Match', 'Suspense', and 'Portal' are supported. ```jsx ``` -_Note these are designed to handle more complex scenarios like template/component insertions. Child expressions are inert unless you return a function. For simple dynamic strings use ternary operator._ +_Note these are designed to handle more complex scenarios like Component insertions. Child expressions are inert unless you return a function. For simple dynamic strings use ternary operator._ The library also includes a couple transform directives that can be applied to the For control flow.