Skip to content

Commit

Permalink
Docs tweaks and removal of relative links
Browse files Browse the repository at this point in the history
  • Loading branch information
ryansolid committed Jun 28, 2021
1 parent 6aac101 commit bb8a290
Show file tree
Hide file tree
Showing 2 changed files with 5 additions and 5 deletions.
8 changes: 3 additions & 5 deletions documentation/guides/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Try Solid

By far the easiest way to get started with Solid is to try it online. Our REPL at https://playground.solidjs.com is the perfect way to try out ideas. As is https://codesandbox.io/ where you can modify any of our [examples](../resources/examples.md).
By far the easiest way to get started with Solid is to try it online. Our REPL at https://playground.solidjs.com is the perfect way to try out ideas. As is https://codesandbox.io/ where you can modify any of our Examples.

Alternatively, you can use our simple [Vite](https://vitejs.dev/) templates by runnings these commands in your terminal:

Expand Down Expand Up @@ -49,9 +49,7 @@ const [last, setLast] = createSignal("Bourne");
createEffect(() => console.log(`${first()} ${last()}`))
```

You can learn more about [Solid's Reactivity](reactivity.md) and [Solid's Rendering](rendering.md).

You can also view our full [API Reference](../api.md).
You can learn more in the Reactivity and Rendering sections.

## Think Solid

Expand Down Expand Up @@ -83,7 +81,7 @@ Solid has a dynamic server side rendering solution that enables a truly isomorph

Since Solid supports asynchronous and streaming rendering on the server, you get to write your code one way and have it execute on the server. This means that features like [render-as-you-fetch](https://reactjs.org/docs/concurrent-mode-suspense.html#approach-3-render-as-you-fetch-using-suspense) and code splitting just work in Solid.

For more information, read the [SSR guide](./server.md).
For more information, read the Server guide.

## No Compilation?

Expand Down
2 changes: 2 additions & 0 deletions documentation/guides/server.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,6 +122,8 @@ Solid's Isomorphic SSR solution is very powerful in that you can write your code

We use markers rendered in the server to match elements and resource locations on server. For this reason the Client and Server should have the same components. This is not typically a problem given that Solid renders the same way on client and server. But currently there is no means to render something on the server that does not get hydrated on the client. Currently, there is no way to partially hydrate a whole page, and not generate hydration markers for it. It is all or nothing. Partial Hydration is something we want to explore in the future.

Finally, all resources need to be defined under the `render` tree. They are automatically serialized and picked up in the browser, but that works because the `render` or `pipeTo` methods keep track of the progress of the render. Something we cannot do if they are created in isolated context. Similarly there is no reactivity on the server so do not update signals on initial render and expect them to reflect higher up the tree. While we have Suspense boundaries Solid's SSR is basically top down.

## Getting Started with SSR

SSR configurations are tricky. We have a few examples in the [solid-ssr](https://github.com/solidjs/solid/blob/main/packages/solid-ssr) package.
Expand Down

0 comments on commit bb8a290

Please sign in to comment.