The actual projection direction of ClusteredDecal is opposite to what the documentation describes.

[chendaohan]

How can Bevy's documentation be improved?

According to both the API documentation and the release notes, ClusteredDecal is supposed to project decals onto surfaces facing the +Z direction. However, in my testing, decals are actually projected onto surfaces facing the -Z direction. I believe this is likely a mistake in the documentation.

As far as I understand, in Bevy, the front face of a object typically faces the -Z direction, so projecting decals in the -Z direction makes sense.

API documentation: https://docs.rs/bevy/0.16.1/bevy/pbr/decal/clustered/struct.ClusteredDecal.html
Release notes: https://bevy.org/news/bevy-0-16/#decals