diff --git a/docs/glossary.md b/docs/glossary.md
index b94cd0fe0a..f1e13e2304 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -75,4 +75,11 @@ expressions such as references to data exported by resources, arithmetic, condit
 Reference: [link](https://opentofu.org/docs/language/expressions/)
 
 ### Variable (HCL)
-Anything that's available to refer to in the current evaluation context.
\ No newline at end of file
+Anything that's available to refer to in the current evaluation context.
+
+## General documentation
+
+### `resource` vs `object`
+In contexts discussing the relationship or interaction between the `resource` HCL block and the associated remote object that it handles, it's recommended to use "resource" for the HCL block and "object" for the remote object (handled by the provider).
+
+Reference: [link](https://github.com/opentofu/opentofu/pull/4153)