bevy/assets
Sélène Amanita cbe13f3aa5
Improve Mesh documentation (#9061)
# Objective

This PR continues https://github.com/bevyengine/bevy/pull/8885

It aims to improve the `Mesh` documentation in the following ways:
- Put everything at the "top level" instead of the "impl".
- Explain better what is a Mesh, how it can be created, and that it can
be edited.
- Explain it can be used with a `Material`, and mention
`StandardMaterial`, `PbrBundle`, `ColorMaterial`, and
`ColorMesh2dBundle` since those cover most cases
- Mention the glTF/Bevy vocabulary discrepancy for "Mesh"
- Add an image for the example
- Various nitpicky modifications

## Note

- The image I added is 90.3ko which I think is small enough?
- Since rustdoc doesn't allow cross-reference not in dependencies of a
subcrate [yet](https://github.com/rust-lang/rust/issues/74481), I have a
lot of backtick references that are not links :(
- Since rustdoc doesn't allow linking to code in the crate (?) I put
link to github directly.
- Since rustdoc doesn't allow embed images in doc
[yet](https://github.com/rust-lang/rust/issues/32104), maybe
[soon](https://github.com/rust-lang/rfcs/pull/3397), I had to put only a
link to the image. I don't think it's worth adding
[embed_doc_image](https://docs.rs/embed-doc-image/latest/embed_doc_image/)
as a dependency for this.
2023-07-31 18:55:42 +00:00
..
android-res/mipmap-mdpi android example polish (#845) 2020-11-11 16:31:16 -08:00
branding Minor Dark/Light Logo Tweak (#4051) 2022-02-27 02:09:42 +00:00
data Asset system rework and GLTF scene loading (#693) 2020-10-18 13:48:15 -07:00
docs Improve Mesh documentation (#9061) 2023-07-31 18:55:42 +00:00
environment_maps EnvironmentMapLight, BRDF Improvements (#7051) 2023-02-09 16:46:32 +00:00
fonts Add the license for the FiraMono font (#3589) 2022-05-06 19:29:43 +00:00
models Add morph targets (#8158) 2023-06-22 20:00:01 +00:00
pixel Add pixelated Bevy to assets and an example (#6408) 2022-11-14 22:15:46 +00:00
scenes (De) serialize resources in scenes (#6846) 2023-03-20 21:17:02 +00:00
shaders Fix shader_material_glsl example after #9254 (#9311) 2023-07-31 13:14:40 +00:00
sounds Add simple collision sound to breakout (#4331) 2022-04-14 20:20:38 +00:00
textures Add parallax mapping to bevy PBR (#5928) 2023-04-15 10:25:14 +00:00