Undocumented DefaultRaycastingPlugin vs. DeferredRaycastingPlugin

[djeedai]

Hi,

I upgraded to 0.16 from an earlier version where I was using DefaultRaycastingPlugin, and nothing worked, the RaycastSource ray was always None. Turns out build_rays() was not called because I needed instead DeferredRaycastingPlugin::<T>. But this doesn't seem to be explained anywhere, and DefaultRaycastingPlugin is not documented either.

Switching to DeferredRaycastingPlugin::<T> instead solved everything. Maybe there should be some mention in the docs?

[aevyrie]

This was mentioned in the changelog for 0.15. There is also extensive documentation at the root of the crate explaining the two APIs and how to choose them: https://docs.rs/bevy_mod_raycast/latest/bevy_mod_raycast/

[djeedai]

I understand the difference between the two APIs, but I don't see any mention of DefaultRaycastingPlugin at the crate root, and I don't understand how that plugin is related to the choice of an API (since it's called "default").

[aevyrie]

Addressed with a rename and docs in 0.18.0-rc.0