From 6a740a8e4551520b5bc84a2fda5ef45612cef84b Mon Sep 17 00:00:00 2001
From: Peeter Piegaze <1153481+ppiegaze@users.noreply.github.com>
Date: Tue, 12 Nov 2024 17:25:44 +0100
Subject: [PATCH] DOC-666 Change "Accessing attributes" to "Accessing
 attributes in workflows" (#5886)

* DOC-666 Change "Accessing attributes" to "Accessing attributes in workflows"

Signed-off-by: Peeter Piegaze <1153481+ppiegaze@users.noreply.github.com>

* Update docs/user_guide/data_types_and_io/accessing_attributes.md

Co-authored-by: Nikki Everett <neverett@users.noreply.github.com>
Signed-off-by: Peeter Piegaze <1153481+ppiegaze@users.noreply.github.com>

---------

Signed-off-by: Peeter Piegaze <1153481+ppiegaze@users.noreply.github.com>
Co-authored-by: Nikki Everett <neverett@users.noreply.github.com>
---
 docs/user_guide/data_types_and_io/accessing_attributes.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/user_guide/data_types_and_io/accessing_attributes.md b/docs/user_guide/data_types_and_io/accessing_attributes.md
index 8df9aaed4d..1eda605183 100644
--- a/docs/user_guide/data_types_and_io/accessing_attributes.md
+++ b/docs/user_guide/data_types_and_io/accessing_attributes.md
@@ -1,13 +1,15 @@
 (attribute_access)=
 
-# Accessing attributes
+# Accessing attributes in workflows
 
 ```{eval-rst}
 .. tags:: Basic
 ```
 
-You can directly access attributes on output promises for lists, dicts, dataclasses and combinations of these types in Flyte. This functionality facilitates the direct passing of output attributes within workflows,
-enhancing the convenience of working with complex data structures.
+You can directly access attributes on output promises for lists, dictionaries, dataclasses, and combinations of these types in Flyte.
+Note that while this functionality may appear to be the normal behavior of Python, code in `@workflow` functions is not actually Python, but rather a Python-like DSL that is compiled by Flyte.
+Consequently, accessing attributes in this manner is, in fact, a specially implemented feature.
+This functionality facilitates the direct passing of output attributes within workflows, enhancing the convenience of working with complex data structures.
 
 ```{note}
 To clone and run the example code on this page, see the [Flytesnacks repo][flytesnacks].