Bevy 0.16 migration guide fixes (#2051)

Author: doup

release-content/0.16/migration-guides/16331_Rename_PointerDownUp__PointerPressedReleased_in_bevy_picki.md

@@ -1,17 +1,12 @@
-__`bevy_picking/src/pointer.rs`:__
+#### `bevy_picking/src/pointer.rs`
 
 __`enum PressDirection`:__
-
-- 
-`PressDirection::Down` changes to `PressDirection::Pressed`.
-
-- 
-`PressDirection::Up` changes to `PressDirection::Released`.
+- `PressDirection::Down` changes to `PressDirection::Pressed`.
+- `PressDirection::Up` changes to `PressDirection::Released`.
 
 These changes are also relevant when working with `enum PointerAction`
 
-
-__`bevy_picking/src/events.rs`:__
+#### `bevy_picking/src/events.rs`
 
 Clicking and pressing Events in events.rs categories change from [Down], [Up], [Click] to [Pressed], [Released], [Click].
 

release-content/0.16/migration-guides/16567_Rename_ArgListpush_methods_to_with_and_add_new_push_method.md

@@ -1,3 +1,9 @@
 Uses of the `ArgList::push` methods should be replaced with the `with` counterpart.
-<details>
-oldnewpush_argwith_argpush_refwith_refpush_mutwith_mutpush_ownedwith_ownedpush_boxedwith_boxed</details>
+
+old|new
+---|---
+push_arg|with_arg
+push_ref|with_ref
+push_mut|with_mut
+push_owned|with_owned
+push_boxed|with_boxed

release-content/0.16/migration-guides/17029_Refactor_hierarchyrelated_commands_to_remove_structs.md

@@ -1,2 +1,16 @@
 If you were queuing the structs of hierarchy-related commands or `SendEvent` directly, you will need to change them to the methods implemented on `EntityCommands` (or `Commands` for `SendEvent`):
-StructMethod`commands.queue(AddChild { child, parent });``commands.entity(parent).add_child(child);` OR `commands.entity(child).set_parent(parent);``commands.queue(AddChildren { children, parent });``commands.entity(parent).add_children(children);``commands.queue(InsertChildren { children, parent });``commands.entity(parent).insert_children(children);``commands.queue(RemoveChildren { children, parent });``commands.entity(parent).remove_children(children);``commands.queue(ReplaceChildren { children, parent });``commands.entity(parent).replace_children(children);``commands.queue(ClearChildren { parent });``commands.entity(parent).clear_children();``commands.queue(RemoveParent { child });``commands.entity(child).remove_parent()``commands.queue(DespawnRecursive { entity, warn: true });``commands.entity(entity).despawn_recursive();``commands.queue(DespawnRecursive { entity, warn: false });``commands.entity(entity).try_despawn_recursive();``commands.queue(DespawnChildrenRecursive { entity, warn: true });``commands.entity(entity).despawn_descendants();``commands.queue(DespawnChildrenRecursive { entity, warn: false});``commands.entity(entity).try_despawn_descendants();``commands.queue(SendEvent { event });``commands.send_event(event);`
+
+Struct|Method
+------|------
+`commands.queue(AddChild { child, parent });`|`commands.entity(parent).add_child(child);` OR `commands.entity(child).set_parent(parent);`
+`commands.queue(AddChildren { children, parent });`|`commands.entity(parent).add_children(children);`
+`commands.queue(InsertChildren { children, parent });`|`commands.entity(parent).insert_children(children);`
+`commands.queue(RemoveChildren { children, parent });`|`commands.entity(parent).remove_children(children);`
+`commands.queue(ReplaceChildren { children, parent });`|`commands.entity(parent).replace_children(children);`
+`commands.queue(ClearChildren { parent });`|`commands.entity(parent).clear_children();`
+`commands.queue(RemoveParent { child });`|`commands.entity(child).remove_parent()`
+`commands.queue(DespawnRecursive { entity, warn: true });`|`commands.entity(entity).despawn_recursive();`
+`commands.queue(DespawnRecursive { entity, warn: false });`|`commands.entity(entity).try_despawn_recursive();`
+`commands.queue(DespawnChildrenRecursive { entity, warn: true });`|`commands.entity(entity).despawn_descendants();`
+`commands.queue(DespawnChildrenRecursive { entity, warn: false});`|`commands.entity(entity).try_despawn_descendants();`
+`commands.queue(SendEvent { event });`|`commands.send_event(event);`

release-content/0.16/migration-guides/17233_If_there_is_no_movement_DragStart_is_not_triggered.md

@@ -1,2 +1 @@
-> 
-Fix the missing part of Drag https://github.com/bevyengine/bevy/pull/16950
+>  Fix the missing part of Drag https://github.com/bevyengine/bevy/pull/16950

release-content/0.16/migration-guides/17702_Use_target_abi__sim_instead_of_ios_simulator_feature.md

@@ -1,2 +1 @@
-> 
-If you’re using a project that builds upon the mobile example, remove the `ios_simulator` feature from your `Cargo.toml` (Bevy now handles this internally).
+If you're using a project that builds upon the mobile example, remove the `ios_simulator` feature from your `Cargo.toml` (Bevy now handles this internally).

release-content/0.16/migration-guides/_guides.toml

@@ -88,12 +88,6 @@ prs = [17967]
 areas = ["Cross-Cutting"]
 file_name = "17967_Upgrade_to_Rust_Edition_2024.md"
 
-[[guides]]
-title = "Don't reëxport `bevy_image` from `bevy_render`"
-prs = [16163]
-areas = ["Cross-Cutting", "Rendering"]
-file_name = "16163_Dont_reëxport_bevy_image_from_bevy_render.md"
-
 [[guides]]
 title = "BRP strict field in query"
 prs = [16725]
@@ -329,7 +323,7 @@ areas = ["ECS"]
 file_name = "16348_Remove_deprecated_component_reads_and_writes.md"
 
 [[guides]]
-title = "Remove flush_and_reserve_invalid_assuming_no_entities"
+title = "Remove `flush_and_reserve_invalid_assuming_no_entities`"
 prs = [16460]
 areas = ["ECS"]
 file_name = "16460_Remove_flush_and_reserve_invalid_assuming_no_entities.md"
@@ -359,7 +353,7 @@ areas = ["ECS"]
 file_name = "17977_Renamed_EventWritersend_methods_to_write.md"
 
 [[guides]]
-title = "Replace VisitEntities with MapEntities"
+title = "Replace `VisitEntities` with `MapEntities`"
 prs = [18432]
 areas = ["ECS"]
 file_name = "18432_Replace_VisitEntities_with_MapEntities.md"
@@ -618,7 +612,7 @@ areas = ["Picking"]
 file_name = "16872_Rename_focus_in_bevy_picking_to_hover.md"
 
 [[guides]]
-title = "Rename Pointer<Down/Up> -> Pointer<Pressed/Released> in bevy_picking."
+title = "Rename `Pointer<Down/Up>` to `Pointer<Pressed/Released>` in `bevy_picking`"
 prs = [16331]
 areas = ["Picking"]
 file_name = "16331_Rename_PointerDownUp__PointerPressedReleased_in_bevy_picki.md"
@@ -875,12 +869,6 @@ prs = [16481]
 areas = ["Rendering"]
 file_name = "16481_cleanup_bevy_renderlibrs.md"
 
-[[guides]]
-title = "doc: fix camera link"
-prs = [16827]
-areas = ["Rendering"]
-file_name = "16827_doc_fix_camera_link.md"
-
 [[guides]]
 title = "`ExtractedSprites` slice buffer"
 prs = [17041]
@@ -1014,10 +1002,10 @@ areas = ["Windowing"]
 file_name = "17121_Support_texture_atlases_in_CustomCursorImage.md"
 
 [[guides]]
-title = ":pencil2: Fix typos across bevy"
-prs = [16702]
-areas = []
-file_name = "16702_pencil2_Fix_typos_across_bevy.md"
+title = "`bevy_utils` Refactor"
+prs = [15801, 16112, 16161, 16951, 17158, 17161, 17250, 17254, 17460, 17577]
+areas = ["Utils"]
+file_name = "bevy_utils_decimation.md"
 
 [[guides]]
 title = "Link iOS example with `rustc`, and avoid C trampoline"
@@ -1054,9 +1042,3 @@ title = "Use `target_abi = \"sim\"` instead of `ios_simulator` feature"
 prs = [17702]
 areas = []
 file_name = "17702_Use_target_abi__sim_instead_of_ios_simulator_feature.md"
-
-[[guides]]
-title = "`bevy_utils` Refactor"
-prs = [15801, 16112, 16161, 16951, 17158, 17161, 17250, 17254, 17460, 17577]
-areas = ["Utils"]
-file_name = "bevy_utils_decimation.md"

release-content/0.16/migration-guides/bevy_core_removed.md

@@ -1,7 +1,7 @@
 `bevy_core` has been removed and its items moved into more appropriate locations.
 Below are some tables showing where items have been moved to
 
-**Structs**
+#### Structs
 
 | Item                             | 0.15 Path   | 0.16 Path         |
 | -------------------------------- | ----------- | ----------------- |
@@ -16,20 +16,20 @@ Below are some tables showing where items have been moved to
 | `TaskPoolThreadAssignmentPolicy` | `bevy_core` | `bevy_app`        |
 | `TypeRegistrationPlugin`         | `bevy_core` | _Removed_         |
 
-**Functions**
+#### Functions
 
 | Item                             | 0.15 Path   | 0.16 Path         |
 | -------------------------------- | ----------- | ----------------- |
 | `update_frame_count`             | `bevy_core` | `bevy_diagnostic` |
 
-**Removed**
+#### Removed
 
-- `TypeRegistrationPlugin` no longer exists. If you can’t use a default `App` but still need `Name` registered, do so manually.
+`TypeRegistrationPlugin` no longer exists. If you can’t use a default `App` but still need `Name` registered, do so manually.
 
-  ```rust
-  // Before
-  app.add_plugins(TypeRegistrationPlugin);
+```rust
+// Before
+app.add_plugins(TypeRegistrationPlugin);
 
-  // After
-  app.register_type::<Name>();
-  ```.
+// After
+app.register_type::<Name>();
+```