agb/book/src/introduction/introduction.md

# Introduction

**agb** is a powerful and easy-to-use library for writing games for the Game Boy Advance (GBA) in rust.
It provides an abstracted interface to the hardware, allowing you to take full advantage of its capabilities without needing to know the low-level details of its implementation.

# What is in this book?

This book serves as an introduction to agb, showcasing its capabilities and providing guidance on how to use it to build your own GBA games.
It assumes that you have some experience with rust and game development, and provides detailed explanations of the unique challenges of writing games for the GBA.

# Who is this book for?

This book is ideal for anyone interested in writing games for the GBA using rust.
If you're new to either rust or game development, you may want to start with some introductory resources before diving into this book.
This book assumes a basic understanding of rust syntax and semantics, as well as game development concepts.

# Helpful links

* [agb's GitHub](https://github.com/agbrs/agb) is the primary development hub for the library.
* [agb's Discussion Page](https://github.com/agbrs/agb/discussions) is a helpful forum where you can ask for help on using agb or share your projects with the community.
* [agb's crates.io page](https://crates.io/crates/agb) the latest version of the library on crates.io.
* [agb's documentation](https://docs.rs/agb) is a useful reference for the library's API and features.
* [Awesome Game Boy Advance development](https://github.com/gbdev/awesome-gbadev) is a comprehensive resource for GBA development, with links to popular libraries, emulators, and the friendly gbadev Discord server.
* [Example games](https://github.com/agbrs/agb/releases/latest) built using agb can be found in the `examples.zip` file attached to the latest release. Additionally, you can also check out [The Hat Chooses the Wizard](https://lostimmortal.itch.io/the-hat-chooses-the-wizard), a game written using agb as part of the GMTK 2021 game jam.

In addition to these resources, this book provides step-by-step instructions for getting started with agb.
Add an introduction 2021-11-23 22:16:12 +00:00			`# Introduction`

Rewrite the introduction 2023-02-25 22:03:18 +00:00			`agb is a powerful and easy-to-use library for writing games for the Game Boy Advance (GBA) in rust.`
			`It provides an abstracted interface to the hardware, allowing you to take full advantage of its capabilities without needing to know the low-level details of its implementation.`
Add an introduction 2021-11-23 22:16:12 +00:00
			`# What is in this book?`

Rewrite the introduction 2023-02-25 22:03:18 +00:00			`This book serves as an introduction to agb, showcasing its capabilities and providing guidance on how to use it to build your own GBA games.`
			`It assumes that you have some experience with rust and game development, and provides detailed explanations of the unique challenges of writing games for the GBA.`
Add an introduction 2021-11-23 22:16:12 +00:00
			`# Who is this book for?`

Rewrite the introduction 2023-02-25 22:03:18 +00:00			`This book is ideal for anyone interested in writing games for the GBA using rust.`
			`If you're new to either rust or game development, you may want to start with some introductory resources before diving into this book.`
			`This book assumes a basic understanding of rust syntax and semantics, as well as game development concepts.`
Add an introduction 2021-11-23 22:16:12 +00:00
			`# Helpful links`

Rewrite the introduction 2023-02-25 22:03:18 +00:00			`* [agb's GitHub](https://github.com/agbrs/agb) is the primary development hub for the library.`
			`* [agb's Discussion Page](https://github.com/agbrs/agb/discussions) is a helpful forum where you can ask for help on using agb or share your projects with the community.`
			`* [agb's crates.io page](https://crates.io/crates/agb) the latest version of the library on crates.io.`
			`* [agb's documentation](https://docs.rs/agb) is a useful reference for the library's API and features.`
			`* [Awesome Game Boy Advance development](https://github.com/gbdev/awesome-gbadev) is a comprehensive resource for GBA development, with links to popular libraries, emulators, and the friendly gbadev Discord server.`
			* [Example games](https://github.com/agbrs/agb/releases/latest) built using agb can be found in the `examples.zip` file attached to the latest release. Additionally, you can also check out [The Hat Chooses the Wizard](https://lostimmortal.itch.io/the-hat-chooses-the-wizard), a game written using agb as part of the GMTK 2021 game jam.

			`In addition to these resources, this book provides step-by-step instructions for getting started with agb.`