From 65bca59a260325951ec778e2d6c4be7087956110 Mon Sep 17 00:00:00 2001
From: GENSON <43442315+genson1808@users.noreply.github.com>
Date: Sat, 23 May 2026 00:47:43 +0900
Subject: [PATCH 1/2] Document BIM Link behavior

---
 wiki/BIM_Link.wikitext | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/wiki/BIM_Link.wikitext b/wiki/BIM_Link.wikitext
index ee14fbb3f0..b8e3c91718 100644
--- a/wiki/BIM_Link.wikitext
+++ b/wiki/BIM_Link.wikitext
@@ -26,6 +26,9 @@
 <!--T:4-->
 The [[File:BIM_Link.svg|24px]] [[BIM_Link|BIM Link]] command is a shortcut to [[Std_LinkMake|Std LinkMake]], but starts a [[Draft_Move|Draft Move]] operation immediately after, allowing a link to be created and placed in one go.
 
+<!--T:8-->
+It creates an {{incode|App::Link}} object that references the selected source object. This is useful when the same BIM object has to appear several times in a model, for example repeated windows, equipment, rebars or curtain-wall elements, while keeping the repeated objects lightweight.
+
 ==Usage== <!--T:5-->
 
 <!--T:6-->
@@ -38,6 +41,19 @@ The [[File:BIM_Link.svg|24px]] [[BIM_Link|BIM Link]] command is a shortcut to [[
 # The [[Draft_Move|Draft Move]] command starts automatically.
 # Click in the [[3D_View|3D View]] to place the new link.
 
+==Notes== <!--T:9-->
+
+<!--T:10-->
+* The command requires at least one selected object.
+* The created object is a standard FreeCAD {{incode|App::Link}}, so changes to the linked source object are reflected by its links.
+* Compared with [[BIM_Clone|BIM Clone]], links are intended for lightweight repeated references to the same geometry. Clones remain available and may still be better supported in older BIM workflows.
+* For BIM objects that need object-specific host information, such as windows, rebars, curtain walls and equipment, the workbench can keep selected link properties independent from the source object. This allows a linked window, for example, to be hosted by a different wall without changing the original window.
+
+==Scripting== <!--T:11-->
+
+<!--T:12-->
+The command creates an {{incode|App::Link}} and assigns its {{incode|LinkedObject}} to the selected source object. It then starts the [[Draft_Move|Draft Move]] command for the newly created link.
+
 
 <!--T:7-->
 {{Docnav
@@ -51,4 +67,4 @@ The [[File:BIM_Link.svg|24px]] [[BIM_Link|BIM Link]] command is a shortcut to [[
 
 </translate>
 {{BIM_Tools_navi{{#translation:}}}}
-{{Userdocnavi{{#translation:}}}}
\ No newline at end of file
+{{Userdocnavi{{#translation:}}}}

From 95e05e091339fe900146b6183113214f6704729d Mon Sep 17 00:00:00 2001
From: GENSON <43442315+genson1808@users.noreply.github.com>
Date: Sat, 23 May 2026 11:00:54 +0900
Subject: [PATCH 2/2] Remove manual translation markers from BIM Link docs

---
 wiki/BIM_Link.wikitext | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/wiki/BIM_Link.wikitext b/wiki/BIM_Link.wikitext
index b8e3c91718..b1b0f81ef5 100644
--- a/wiki/BIM_Link.wikitext
+++ b/wiki/BIM_Link.wikitext
@@ -26,7 +26,6 @@
 <!--T:4-->
 The [[File:BIM_Link.svg|24px]] [[BIM_Link|BIM Link]] command is a shortcut to [[Std_LinkMake|Std LinkMake]], but starts a [[Draft_Move|Draft Move]] operation immediately after, allowing a link to be created and placed in one go.
 
-<!--T:8-->
 It creates an {{incode|App::Link}} object that references the selected source object. This is useful when the same BIM object has to appear several times in a model, for example repeated windows, equipment, rebars or curtain-wall elements, while keeping the repeated objects lightweight.
 
 ==Usage== <!--T:5-->
@@ -41,17 +40,15 @@ It creates an {{incode|App::Link}} object that references the selected source ob
 # The [[Draft_Move|Draft Move]] command starts automatically.
 # Click in the [[3D_View|3D View]] to place the new link.
 
-==Notes== <!--T:9-->
+==Notes==
 
-<!--T:10-->
 * The command requires at least one selected object.
 * The created object is a standard FreeCAD {{incode|App::Link}}, so changes to the linked source object are reflected by its links.
 * Compared with [[BIM_Clone|BIM Clone]], links are intended for lightweight repeated references to the same geometry. Clones remain available and may still be better supported in older BIM workflows.
 * For BIM objects that need object-specific host information, such as windows, rebars, curtain walls and equipment, the workbench can keep selected link properties independent from the source object. This allows a linked window, for example, to be hosted by a different wall without changing the original window.
 
-==Scripting== <!--T:11-->
+==Scripting==
 
-<!--T:12-->
 The command creates an {{incode|App::Link}} and assigns its {{incode|LinkedObject}} to the selected source object. It then starts the [[Draft_Move|Draft Move]] command for the newly created link.