Copilot commented on code in PR #60507:
URL: https://github.com/apache/airflow/pull/60507#discussion_r3066472263
##########
airflow-core/docs/templates-ref.rst:
##########
@@ -201,13 +201,13 @@ A few commonly used libraries and methods are made
available.
=================================
========================================================================================================================================================================
Variable Description
=================================
========================================================================================================================================================================
-``macros.datetime`` The standard lib's
:class:`datetime.datetime`.
+``macros.datetime`` The standard lib's
:py:class:`datetime.datetime`.
Note: ``utcnow()`` is deprecated in Python
3.12+; use ``now(macros.dateutil.tz.UTC)`` instead.
-``macros.timedelta`` The standard lib's
:class:`datetime.timedelta`
+``macros.timedelta`` The standard lib's
:py:class:`datetime.timedelta`
``macros.dateutil`` A reference to the ``dateutil`` package
``macros.time`` The standard lib's :mod:`time`
``macros.uuid`` The standard lib's :mod:`uuid`
-``macros.random`` The standard lib's :class:`random.random`
+``macros.random`` The standard lib's
:py:class:`random.random`
Review Comment:
`random.random` is a function, not a class, so `:py:class:` is the wrong
role and may produce an incorrect/failed cross-reference. Use the Python
function role (e.g., `:py:func:`) for `random.random`.
```suggestion
``macros.random`` The standard lib's
:py:func:`random.random`
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
