Hacker News Reader

Comment by Buttons840 | Hacker News Reader

I'm put off by the limited docs. I've read the Bevy book, only takes a few minutes, and just like that I'm out of resources to turn to when I get stuck.

When will the docs improve? I look at the release notes and ideally every one of those features would have several pages of docs. I understand that's a lot of work, and maybe things will have to stabilize before we get full docs?

View on HN

Among Bevy contributors (including myself) there is a general hesitance to invest too much time in official learning material that will be obsolete by the next release. Bevy's APIs are beginning to stabilize ... and the appetite (both from users and from Bevy devs) for official material is increasing. The time is coming (soon)!

While you wait, there are a sizeable number of tutorials on YouTube, and we have learning material linked in https://bevyengine.org/assets/#learning as well.

Nit: developers who use bevy should be called bevy devys.

There's an unofficial complement to the docs that covers a lot of different topics here: https://bevy-cheatbook.github.io/introduction.html

Unfortunately it's somewhat out of date

I mean, Bevy 0.12 was released... Yesterday.

Most pages are for version 0.11 or 0.12 already, and not much changed between the two versions besides the assets, if you already have a game written in 0.11. Together with the release notes, you'll survive :)

The cheat book is written for some smeared set of versions since it's inception. It is out of date for 0.11 as well. The effort to keep it up to date is somewhat low since Bevy changes so much an so often in its current development.

Bevy does have plenty of documentation here: https://docs.rs/bevy/latest/bevy/

What's missing is tutorial type documentation, but individual features are generally documented.

The examples in the github repo are fantastic and cover a lot of ground. That's usually my goto when trying to figure things out.

I've been writing https://taintedcoders.com/ for a while and will be keeping it on the bleeding edge. Hope you find it useful.

Reply on news.ycombinator.com