agbrs / agb

Library for writing Game Boy Advance games in Rust
https://agbrs.dev/
Mozilla Public License 2.0
320 stars 27 forks source link

Add interactive examples and clean up existing ones #789

Open corwinkuiper opened 1 month ago

corwinkuiper commented 1 month ago

We have an examples page on the agb website that we haven't publicised due to the examples being rather poor in this context. Ideally the examples would be interactive and visually interesting from the automatically generated screenshot.

Furthermore some examples should just be removed for a lack of anything interesting.

flydecahedron commented 1 month ago

Happy to help out with this. Here's my thoughts on making the examples better:

corwinkuiper commented 1 month ago

Include the code of the example on the published page, like how bevy does it.

This is already something we do, see https://agbrs.dev/examples/chicken for example.

We also have game examples that show the workflow, I don't think the agb examples should be large enough to need to show workflows.

flydecahedron commented 1 month ago

Huh weird, either the code wasn't rendering on my browser or I was blind when I checked last 🤷 Cool that it's already setup like that, though!

Maybe describing the workflows would fit better in the book/tutorial, then? I think it would be nice have a singular place to show the current recommended way to make maps, write songs, etc. The workflows in the game examples seem to have evolved over time.