Relations reordering: Dev docs updates - alternative

docs/.vuepress/config/sidebar-developer.js

@@ -242,6 +242,7 @@ const developer = [
               ],
             ]
           },
+          ['/developer-docs/latest/developer-resources/database-apis-reference/rest/relations.html', 'Relations']
         ],
       },
       [

docs/developer-docs/latest/developer-resources/database-apis-reference/entity-service/crud.md

@@ -85,6 +85,8 @@ Syntax: `create(uid: string, parameters: Params)` ⇒ `Entry`
 | `populate` | Relations, components and dynamic zones to [populate](/developer-docs/latest/developer-resources/database-apis-reference/entity-service/populate.md) | [`PopulateParameter`<Fa-Link color="grey"/>](/developer-docs/latest/developer-resources/database-apis-reference/entity-service/populate.md) |
 | `data`     | Input data                                                                                                                                             | `Object`                                                                                                                                      |
 
+!!!include(developer-docs/latest/developer-resources/database-apis-reference/snippets/managing-relations.md)!!!
+
 ### Example
 
 ```js
@@ -105,6 +107,8 @@ Updates one entry and returns it.
 
 Syntax: `update(uid: string, id: ID, parameters: Params)` ⇒ `Entry`
 
+!!!include(developer-docs/latest/developer-resources/database-apis-reference/snippets/managing-relations.md)!!!
+
 ### Parameters
 
 | Parameter  | Description                                                                                                                                            | Type                                                                                                                                          |

docs/developer-docs/latest/developer-resources/database-apis-reference/query-engine/single-operations.md

@@ -113,6 +113,8 @@ const entry = await strapi.db.query('api::blog.article').create({
 });
 ```
 
+!!!include(developer-docs/latest/developer-resources/database-apis-reference/snippets/managing-relations.md)!!!
+
 ## update()
 
 Updates one entry and returns it.
@@ -139,6 +141,8 @@ const entry = await strapi.db.query('api::blog.article').update({
 });
 ```
 
+!!!include(developer-docs/latest/developer-resources/database-apis-reference/snippets/managing-relations.md)!!!
+
 ## delete()
 
 Deletes one entry and returns it.

docs/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md

@@ -265,6 +265,10 @@ If the [Internationalization (i18n) plugin](/developer-docs/latest/plugins/i18n.
 
 ::::
 
+:::note
+While creating an entry, you can define its relations and their order (see [Managing relations through the REST API](/developer-docs/latest/developer-resources/database-apis-reference/rest/relations.md) for more details).
+:::
+
 ### Update an entry
 
 Partially updates an entry by `id` and returns its value.
@@ -304,8 +308,9 @@ Fields that aren't sent in the query are not changed in the database. Send a `nu
 
 ::::
 
-:::note
-Even with the [Internationalization (i18n) plugin](/developer-docs/latest/plugins/i18n.md) installed, it's currently not possible to [update the locale of an entry](/developer-docs/latest/plugins/i18n.md#updating-an-entry).
+:::note NOTES
+* Even with the [Internationalization (i18n) plugin](/developer-docs/latest/plugins/i18n.md) installed, it's currently not possible to [update the locale of an entry](/developer-docs/latest/plugins/i18n.md#updating-an-entry).
+* While updating an entry, you can define its relations and their order (see [Managing relations through the REST API](/developer-docs/latest/developer-resources/database-apis-reference/rest/relations.md) for more details).
 :::
 
 ### Delete an entry