Editing pass for the migration guide (#1499)

Co-authored-by: Alice Cecile <[email protected]>
Co-authored-by: BD103 <[email protected]>

Author: 3 people

content/learn/migration-guides/0.13-to-0.14.md

@@ -4,7 +4,6 @@ insert_anchor_links = "right"
 [extra]
 weight = 9
 long_title = "Migration Guide: 0.13 to 0.14"
-public_draft = 1188
 +++
 
 {{ migration_guides(version="0.14") }}

release-content/0.14/migration-guides/12314_Clean_up_type_registrations.md

@@ -1,4 +1,4 @@
-External types are no longer registered into the type registry automatically unless they are used by other Bevy types (due to the new recursive registration). If you were depending on types from `std`, `glam`, or similar types being in the type registry you may need to manually register them.
+Many external types are no longer registered into the type registry by Bevy's default plugin. Generally, only types used by other Bevy types (due to the new recursive registration) will be registered by default. If you were using reflection features with types from `std` or `glam` you may need to manually register them.
 
 ```rust
 App::new().register_type::<DMat3>();

release-content/0.14/migration-guides/12547_Add_AsyncSeek_trait_to_Reader_to_be_able_to_seek_inside_as.md

@@ -1 +1,3 @@
 The asset loader's `Reader` type alias now requires the new `AsyncSeek` trait. Please implement `AsyncSeek` for any structures that must be a `Reader`, or use an alternative if seeking is not supported.
+
+If this is a problem for you, please chime in at [bevy#12880](https://github.com/bevyengine/bevy/issues/12880) and help us improve the design for 0.15!

release-content/0.14/migration-guides/12551_Remove_WorldCell.md

@@ -1,3 +1,3 @@
-`WorldCell` has been removed due to its incomplete, less performant, and potentially confusing nature. If you were using it to fetch multiple distinct values, consider using a `SystemState` instead with the `SystemState::get()` method.
+`WorldCell` has been removed due to its incomplete nature, tendency to generate runtime panics, and the presence of multiple good alternatives. If you were using it to fetch multiple distinct resource values, consider using a `SystemState` instead with the `SystemState::get()` method.
 
 If `SystemState` does not fit your use-case and `unsafe` is tolerable, you can use `UnsafeWorldCell`. It is more performant and featureful, but lacks the runtime checks.

release-content/0.14/migration-guides/12666_FIX12527_Changes_to_make_serde_optional_for_bevy_color.md

@@ -1,3 +1,21 @@
+[[guides]]
+title = "Overhaul `Color`"
+url = "https://github.com/bevyengine/bevy/pull/12163"
+areas = ["Color", "Gizmos", "Rendering", "Text", "UI"]
+file_name = "12163_Migrate_from_LegacyColor_to_bevy_colorColor.md"
+
+[[guides]]
+title = "Make default behavior for `BackgroundColor` and `BorderColor` more intuitive"
+url = "https://github.com/bevyengine/bevy/pull/14017"
+areas = ["Rendering", "UI"]
+file_name = "14017_Make_default_behavior_for_BackgroundColor_and_BorderColor_.md"
+
+[[guides]]
+title = "Register missing types manually"
+url = "https://github.com/bevyengine/bevy/pull/12314"
+areas = ["Reflection"]
+file_name = "12314_Clean_up_type_registrations.md"
+
 [[guides]]
 title = "Fix `Node2d` typo"
 url = "https://github.com/bevyengine/bevy/pull/12038"
@@ -29,7 +47,7 @@ areas = ["Animation"]
 file_name = "11989_Implement_the_AnimationGraph_allowing_for_multiple_animati.md"
 
 [[guides]]
-title = "Multiplying `LinearRgba` by `f32` no longer ignores alpha channel"
+title = "Multiplying colors by `f32` no longer ignores alpha channel"
 url = "https://github.com/bevyengine/bevy/pull/12575"
 areas = ["Animation", "Color", "Math", "Rendering"]
 file_name = "12575_Color_maths_4.md"
@@ -77,7 +95,7 @@ areas = ["Assets"]
 file_name = "12605_Make_AssetActionIgnore_not_copy_assets_to_imported_assets.md"
 
 [[guides]]
-title = "Removed `Into<AssedId<T>>` for `Handle<T>`"
+title = "Removed `Into<AssetId<T>>` for `Handle<T>`"
 url = "https://github.com/bevyengine/bevy/pull/12655"
 areas = ["Assets"]
 file_name = "12655_Removed_IntoAssedIdT_for_HandleT_as_mentioned_in_12600.md"
@@ -130,12 +148,6 @@ url = "https://github.com/bevyengine/bevy/pull/13209"
 areas = ["Color"]
 file_name = "13209_move_wgsl_color_operations_from_bevy_pbr_to_bevy_render.md"
 
-[[guides]]
-title = "Overhaul `Color`"
-url = "https://github.com/bevyengine/bevy/pull/12163"
-areas = ["Color", "Gizmos", "Rendering", "Text", "UI"]
-file_name = "12163_Migrate_from_LegacyColor_to_bevy_colorColor.md"
-
 [[guides]]
 title = "Remove old color space utilities"
 url = "https://github.com/bevyengine/bevy/pull/12105"
@@ -430,12 +442,6 @@ url = "https://github.com/bevyengine/bevy/pull/5781"
 areas = ["Reflection"]
 file_name = "5781_bevy_reflect_Recursive_registration.md"
 
-[[guides]]
-title = "Clean up type registrations"
-url = "https://github.com/bevyengine/bevy/pull/12314"
-areas = ["Reflection"]
-file_name = "12314_Clean_up_type_registrations.md"
-
 [[guides]]
 title = "Rename `UntypedReflectDeserializer` to `ReflectDeserializer`"
 url = "https://github.com/bevyengine/bevy/pull/12721"
@@ -682,18 +688,6 @@ url = "https://github.com/bevyengine/bevy/pull/13462"
 areas = ["Rendering", "UI"]
 file_name = "13462_Fix_UI_elements_randomly_not_appearing_after_13277.md"
 
-[[guides]]
-title = "Make default behavior for `BackgroundColor` and `BorderColor` more intuitive"
-url = "https://github.com/bevyengine/bevy/pull/14017"
-areas = ["Rendering", "UI"]
-file_name = "14017_Make_default_behavior_for_BackgroundColor_and_BorderColor_.md"
-
-[[guides]]
-title = "Make `serde` optional for `bevy_color`"
-url = "https://github.com/bevyengine/bevy/pull/12666"
-areas = ["Rendering", "Utils"]
-file_name = "12666_FIX12527_Changes_to_make_serde_optional_for_bevy_color.md"
-
 [[guides]]
 title = "Rename `need_new_surfaces()` system to `need_surface_configuration()`"
 url = "https://github.com/bevyengine/bevy/pull/12055"