From eeb8f67f837facb37f092a8b743f4d249515e82f Mon Sep 17 00:00:00 2001
From: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
Date: Thu, 6 Jun 2024 11:56:58 +0100
Subject: [PATCH] gh-119786: move adaptive interpreter doc from Python to
 InternalsDoc (#120137)

---
 InternalDocs/README.md               |  1 +
 {Python => InternalDocs}/adaptive.md | 10 ++++++----
 2 files changed, 7 insertions(+), 4 deletions(-)
 rename {Python => InternalDocs}/adaptive.md (93%)

diff --git a/InternalDocs/README.md b/InternalDocs/README.md
index e69e27d1542..a2502fbf198 100644
--- a/InternalDocs/README.md
+++ b/InternalDocs/README.md
@@ -14,3 +14,4 @@ # CPython Internals Documentation
 
 [Exception Handling](exception_handling.md)
 
+[Adaptive Instruction Families](adaptive.md)
diff --git a/Python/adaptive.md b/InternalDocs/adaptive.md
similarity index 93%
rename from Python/adaptive.md
rename to InternalDocs/adaptive.md
index d978c089b23..09245730b27 100644
--- a/Python/adaptive.md
+++ b/InternalDocs/adaptive.md
@@ -2,8 +2,9 @@ # Adding or extending a family of adaptive instructions.
 
 ## Families of instructions
 
-The core part of PEP 659 (specializing adaptive interpreter) is the families
-of instructions that perform the adaptive specialization.
+The core part of [PEP 659](https://peps.python.org/pep-0659/)
+(specializing adaptive interpreter) is the families of
+instructions that perform the adaptive specialization.
 
 A family of instructions has the following fundamental properties:
 
@@ -30,8 +31,9 @@ ## Families of instructions
 
 ## Example family
 
-The `LOAD_GLOBAL` instruction (in Python/bytecodes.c) already has an adaptive
-family that serves as a relatively simple example.
+The `LOAD_GLOBAL` instruction (in
+[Python/bytecodes.c](https://github.com/python/cpython/blob/main/Python/bytecodes.c))
+already has an adaptive family that serves as a relatively simple example.
 
 The `LOAD_GLOBAL` instruction performs adaptive specialization,
 calling `_Py_Specialize_LoadGlobal()` when the counter reaches zero.