7e18356da6
# Objective Separate example explanation (file docblock) and the code so they can be layout differently in the website and we can give a higher importance to the explanation on the [website search tool](https://github.com/bevyengine/bevy-website/pull/1935). This would also allow us to improve the examples so they become even more like a cookbook. ## Solution Update the `example-showcase` tool to extract the example file docblock and write it as the example markdown content. This allows us to access the explanation via `page.content` in Zola. ## Testing I've checked that the output is correct after running the tool and it doesn't throw any error. I've also validated that the approach will work on the website. ## Showcase This is a quick and dirty example of what we could do in the web examples after the change. When we implement the real thing we can put the explanation on a sidebar or explore other layout options. <img width="1362" alt="image" src="https://github.com/user-attachments/assets/6738542e-31c3-41cd-972a-7fa2e942e85d" /> |
||
|---|---|---|
| .. | ||
| src | ||
| asset-source-website.patch | ||
| Cargo.toml | ||
| disable-audio.patch | ||
| extra-window-resized-events.patch | ||
| fixed-window-position.patch | ||
| reduce-light-cluster-config.patch | ||
| remove-desktop-app-mode.patch | ||
| window-settings-wasm.patch | ||