Add interactive examples and clean up existing ones
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.
Happy to help out with this. Here's my thoughts on making the examples better:
- An example game that uses a recommended workflow
- tiled, aseprite, tracker, .wav sound effects
- as simple as possible. Perhaps a "clicker" game?
- Find/make an example tileset in the style of classic gba games to make the screenshots pop
- Focus on most used features i.e. sprites & tiled backgrounds vs bitmap modes.
- top level rustdoc comment giving a summary.
- Include the code of the example on the published page, like how bevy does it.
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.
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.