Fix issue with related nodes

Author: dgarros

docs/docs/python-sdk/topics/object_file.mdx

@@ -64,7 +64,7 @@ spec:
 
 > Multiple documents in a single YAML file are also supported, each document will be loaded separately. Documents are separated by `---`
 
-### Relationship of cardinality One
+### Relationship of cardinality one
 
 A relationship of cardinality one can either reference an existing node via its HFID or create a new node if it doesn't exist.
 In the example below, both `site` and `primary_ip` are relationships of cardinality one.
@@ -83,7 +83,7 @@ spec:
             address: "192.168.1.1"
 ```
 
-### Relationship of cardinality Many
+### Relationship of cardinality many
 
 A relationship of cardinality many can reference existing nodes via their HFID or define nested objects.
 
@@ -111,7 +111,7 @@ spec:
         - [Breeder]       # Existing Node referenced by its HFID in list format
 ```
 
-#### Nested Objects
+#### Nested objects
 
 When defining nested objects, the node will be automatically created if it doesn't exist and if the relationship between the parent object and the nested object exists, it will be automatically inserted.
 For example, in the example below, the `owner` of a `TestingDog` doesn't need to be specified because it will be automatically inserted.
@@ -175,19 +175,19 @@ spec:
             breed: Persian
 ```
 
-### Support for Metadata
+### Support for metadata
 
 Metadata support is planned for future releases. Currently, the Object file does not support metadata on attributes or relationships.
 
 ## Troubleshooting
 
-### Common Issues
+### Common issues
 
 1. **Objects not being created**: Ensure that the YAML syntax is correct and that the file follows the required format.
 2. **Dependency errors**: When objects depend on each other, load them in the correct order (dependencies first).
 3. **Validation errors**: Use the `infrahub object validate` command to check for syntax errors before loading.
 
-### Best Practices
+### Best practices
 
 1. Use Human Friendly IDs (HFIDs) for all objects to ensure consistent referencing.
 2. Keep object files organized by model type or purpose.

infrahub_sdk/spec/object.py

@@ -433,7 +433,7 @@ async def create_node(
 
             await cls.create_related_nodes(
                 client=client,
-                node=node,
+                parent_node=node,
                 rel_info=rel_info,
                 position=position,
                 data=data[rel],
@@ -451,7 +451,7 @@ async def create_related_nodes(
         rel_info: RelationshipInfo,
         position: list[int | str],
         data: dict | list[dict],
-        node: InfrahubNode | None = None,
+        parent_node: InfrahubNode | None = None,
         context: dict | None = None,
         branch: str | None = None,
         default_schema_kind: str | None = None,
@@ -463,11 +463,11 @@ async def create_related_nodes(
             peer_kind = data.get("kind") or rel_info.peer_kind
             peer_schema = await client.schema.get(kind=peer_kind, branch=branch)
 
-            if node:
+            if parent_node:
                 rel_info.find_matching_relationship(peer_schema=peer_schema)
-                context.update(rel_info.get_context(value=node.id))
+                context.update(rel_info.get_context(value=parent_node.id))
 
-            node = await cls.create_node(
+            new_node = await cls.create_node(
                 client=client,
                 schema=peer_schema,
                 position=position,
@@ -476,15 +476,15 @@ async def create_related_nodes(
                 branch=branch,
                 default_schema_kind=default_schema_kind,
             )
-            return [node]
+            return [new_node]
 
         if isinstance(data, dict) and rel_info.format == RelationshipDataFormat.MANY_OBJ_DICT_LIST:
             peer_kind = data.get("kind") or rel_info.peer_kind
             peer_schema = await client.schema.get(kind=peer_kind, branch=branch)
 
-            if node:
+            if parent_node:
                 rel_info.find_matching_relationship(peer_schema=peer_schema)
-                context.update(rel_info.get_context(value=node.id))
+                context.update(rel_info.get_context(value=parent_node.id))
 
             for idx, peer_data in enumerate(data["data"]):
                 context["list_index"] = idx
@@ -508,9 +508,9 @@ async def create_related_nodes(
                 peer_kind = item.get("kind") or rel_info.peer_kind
                 peer_schema = await client.schema.get(kind=peer_kind, branch=branch)
 
-                if node:
+                if parent_node:
                     rel_info.find_matching_relationship(peer_schema=peer_schema)
-                    context.update(rel_info.get_context(value=node.id))
+                    context.update(rel_info.get_context(value=parent_node.id))
 
                 node = await cls.create_node(
                     client=client,