From 496b36f17ae1308bbe4225406d5f2eb223769213 Mon Sep 17 00:00:00 2001
From: Stanley <46876382+slateny@users.noreply.github.com>
Date: Thu, 22 Dec 2022 15:23:25 -0800
Subject: [PATCH] gh-48496: Added example and link to faq for UnboundLocalError
 in reference (GH-93068) (cherry picked from commit
 f3db68e6e66ebb36e1b9cb30daba913ecc736169)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
---
 Doc/faq/programming.rst          | 2 ++
 Doc/reference/executionmodel.rst | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst
index 584d33e9622e33..c396e2b081fca3 100644
--- a/Doc/faq/programming.rst
+++ b/Doc/faq/programming.rst
@@ -113,6 +113,8 @@ Yes.  The coding style required for standard library modules is documented as
 Core Language
 =============
 
+.. _faq-unboundlocalerror:
+
 Why am I getting an UnboundLocalError when the variable has a value?
 --------------------------------------------------------------------
 
diff --git a/Doc/reference/executionmodel.rst b/Doc/reference/executionmodel.rst
index 3f01180e13f776..a264015cbf4049 100644
--- a/Doc/reference/executionmodel.rst
+++ b/Doc/reference/executionmodel.rst
@@ -128,6 +128,8 @@ lead to errors when a name is used within a block before it is bound.  This rule
 is subtle.  Python lacks declarations and allows name binding operations to
 occur anywhere within a code block.  The local variables of a code block can be
 determined by scanning the entire text of the block for name binding operations.
+See :ref:`the FAQ entry on UnboundLocalError <faq-unboundlocalerror>`
+for examples.
 
 If the :keyword:`global` statement occurs within a block, all uses of the names
 specified in the statement refer to the bindings of those names in the top-level