godot-rust / book

Documentation and tutorials for gdext, the Rust bindings for Godot 4

The godot-rust book

The godot-rust book is a user guide for gdext, the Rust bindings to Godot 4. The book is still work-in-progress, and contributions are very welcome.

An online version of the book is available at godot-rust.github.io/book.
For the gdnative book, check out gdnative-book.

The book is built with mdBook and the plugins mdbook-toc and mdbook-admonish. To install them and build the book locally, you can run:

cargo install mdbook mdbook-toc mdbook-admonish
mdbook build

To run a local server with automatic updates while editing the book, use:

mdbook serve --open

Formatting and linting

We use markdownlint to enforce a consistent style across the Markdown files. It is automatically run during CI, but if you have the npm toolchain, you can also run it locally:

npm install --global markdownlint-cli2
./lint.sh

Contributing

This repository is for documentation only. Please open pull requests targeting the gdext library itself in the main repo. Please read the corresponding contributing guidelines in Contributing.md.

License

Like gdext itself, the gdext book is licensed under MPL 2.0.