Some of the examples on the Svelte website are straightforward/intuitive but others need some explanation/documentation. For example, the "Deferred transitions" example is excellent but there are a lot of things going on and it's difficult to understand. In particular, what is the essential lesson of the example vs. understanding all the code needed to demonstrate it.

Therefore, I recommend:

• Review of each example
• Adding a README file to each example. Perhaps a README.svelte file could be added to each example.
• Adding more comments to each example.

e.g.

App.svelte

<script>
	import README from './README.svelte';

	let name = 'world';
</script>


<README />

<h1>Hello {name}!</h1>

README.svelte

<hr>
<h1>
	README - Hello world
</h1>

This example shows how a variable in the script section can be used in a HTML template.