From 75b0676c9598d04447d485e689f32acec39f3c6a Mon Sep 17 00:00:00 2001
From: Sarita Iyer <66540150+saritai@users.noreply.github.com>
Date: Fri, 3 Feb 2023 13:37:53 -0500
Subject: [PATCH] Add tocs with links to deprecated articles

---
 docs/codeql/codeql-cli/about-codeql-packs.rst | 18 +++++++++++++-
 .../codeql-cli/about-codeql-workspaces.rst    |  8 ++++++-
 .../codeql-cli/about-the-codeql-cli.rst       |  6 ++++-
 ...nalyzing-databases-with-the-codeql-cli.rst | 18 +++++++++++++-
 ...creating-and-working-with-codeql-packs.rst | 10 +++++++-
 .../codeql-cli/creating-codeql-databases.rst  | 17 ++++++++++++-
 .../creating-codeql-query-suites.rst          | 14 ++++++++++-
 docs/codeql/codeql-cli/exit-codes.rst         |  2 +-
 docs/codeql/codeql-cli/extractor-options.rst  |  8 ++++++-
 .../getting-started-with-the-codeql-cli.rst   | 18 +++++++++++++-
 .../publishing-and-using-codeql-packs.rst     | 12 +++++++++-
 .../codeql-cli/query-reference-files.rst      |  7 +++++-
 docs/codeql/codeql-cli/sarif-output.rst       | 24 ++++++++++++++++++-
 ...options-in-a-codeql-configuration-file.rst |  7 +++++-
 .../codeql-cli/testing-custom-queries.rst     | 12 +++++++++-
 .../codeql-cli/testing-query-help-files.rst   |  8 ++++++-
 ...ing-custom-queries-with-the-codeql-cli.rst |  9 ++++++-
 .../codeql-cli-migration-toc-note.rst         |  1 +
 18 files changed, 182 insertions(+), 17 deletions(-)
 create mode 100644 docs/codeql/reusables/codeql-cli-migration-toc-note.rst

diff --git a/docs/codeql/codeql-cli/about-codeql-packs.rst b/docs/codeql/codeql-cli/about-codeql-packs.rst
index ec18563f5f9f..5aa0462e85d6 100644
--- a/docs/codeql/codeql-cli/about-codeql-packs.rst
+++ b/docs/codeql/codeql-cli/about-codeql-packs.rst
@@ -6,4 +6,20 @@ About CodeQL packs
 .. pull-quote:: 
   This article was moved to "`About CodeQL packs <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `CodeQL pack structure <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#codeql-pack-structure>`__
+    * `About published packs <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#about-published-packs>`__
+* `About qlpack.yml files <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#about-qlpackyml-files>`__
+    * `qlpack.yml properties <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#qlpackyml-properties>`__
+* `About codeql-pack.lock.yml files <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#about-codeql-packlockyml-files>`__
+* `Examples of custom CodeQL packs <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#examples-of-custom-codeql-packs>`__
+    * `CodeQL packs for custom libraries <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#codeql-packs-for-custom-libraries>`__
+    * `CodeQL packs for custom queries <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#codeql-packs-for-custom-queries>`__
+    * `CodeQL packs for custom tests <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#codeql-packs-for-custom-tests>`__
+* `Examples of CodeQL packs in the CodeQL repository <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#examples-of-codeql-packs-in-the-codeql-repository>`__
+    * `Core library pack <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#core-library-pack>`__
+    * `Core query pack <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#core-query-pack>`__
+    * `Tests for the core CodeQL pack <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-packs#tests-for-the-core-codeql-pack>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/about-codeql-workspaces.rst b/docs/codeql/codeql-cli/about-codeql-workspaces.rst
index e1e66adf6bd5..3faa45d7d72d 100644
--- a/docs/codeql/codeql-cli/about-codeql-workspaces.rst
+++ b/docs/codeql/codeql-cli/about-codeql-workspaces.rst
@@ -7,4 +7,10 @@ About CodeQL workspaces
   This article was moved to "`About CodeQL workspaces <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-workspaces>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
   .. include:: ../reusables/codeql-cli-articles-migration-note.rst
-  
\ No newline at end of file
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `The codeql-workspace.yml file <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-workspaces#the-codeql-workspaceyml-file>`__
+* `Source dependencies <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-workspaces#source-dependencies>`__
+* `CodeQL workspaces and query resolution <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-workspaces#codeql-workspaces-and-query-resolution>`__
+    * `Example <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/about-codeql-workspaces#example>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/about-the-codeql-cli.rst b/docs/codeql/codeql-cli/about-the-codeql-cli.rst
index 9d446ccee8eb..e155d5f12e0b 100644
--- a/docs/codeql/codeql-cli/about-the-codeql-cli.rst
+++ b/docs/codeql/codeql-cli/about-the-codeql-cli.rst
@@ -6,4 +6,8 @@ About the CodeQL CLI
 .. pull-quote:: 
   This article was moved to "`About the CodeQL CLI <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/about-the-codeql-cli>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `CodeQL CLI commands <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/about-the-codeql-cli#codeql-cli-commands>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/analyzing-databases-with-the-codeql-cli.rst b/docs/codeql/codeql-cli/analyzing-databases-with-the-codeql-cli.rst
index 018aa6b8b4fb..0739abccdeae 100644
--- a/docs/codeql/codeql-cli/analyzing-databases-with-the-codeql-cli.rst
+++ b/docs/codeql/codeql-cli/analyzing-databases-with-the-codeql-cli.rst
@@ -6,4 +6,20 @@ Analyzing databases with the CodeQL CLI
 .. pull-quote:: 
   This article was moved to "`Analyzing databases with the CodeQL CLI <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `Running codeql database analyze <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#running-codeql-database-analyze>`__
+* `Specifying which queries to run in a CodeQL pack <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#specifying-which-queries-to-run-in-a-codeql-pack>`__
+    * `Example query specifiers <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#example-query-specifiers>`__
+* `Examples of running database analyses <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#examples-of-running-database-analyses>`__
+    * `Running a CodeQL query pack <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#running-a-codeql-query-pack>`__
+    * `Running a single query <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#running-a-single-query>`__
+    * `Running all queries in a directory <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#running-all-queries-in-a-directory>`__
+    * `Running a subset of queries in a CodeQL pack <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#running-a-subset-of-queries-in-a-codeql-pack>`__
+    * `Running query suites <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#running-query-suites>`__
+        * `Diagnostic and summary information <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#diagnostic-and-summary-information>`__
+    * `Integrating a CodeQL pack into a code scanning workflow in GitHub <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#integrating-a-codeql-pack-into-a-code-scanning-workflow-in-github>`__
+    * `Including query help for custom CodeQL queries in SARIF files <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#including-query-help-for-custom-codeql-queries-in-sarif-files>`__
+* `Results <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/analyzing-databases-with-the-codeql-cli#results>`__
diff --git a/docs/codeql/codeql-cli/creating-and-working-with-codeql-packs.rst b/docs/codeql/codeql-cli/creating-and-working-with-codeql-packs.rst
index d5e83ac93cd9..5354a9eabd10 100644
--- a/docs/codeql/codeql-cli/creating-and-working-with-codeql-packs.rst
+++ b/docs/codeql/codeql-cli/creating-and-working-with-codeql-packs.rst
@@ -6,4 +6,12 @@ Creating and working with CodeQL packs
 .. pull-quote:: 
   This article was moved to "`Creating and working with CodeQL packs <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-and-working-with-codeql-packs>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `About CodeQL packs and the CodeQL CLI <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-and-working-with-codeql-packs#about-codeql-packs-and-the-codeql-cli>`__
+* `Creating a CodeQL pack <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-and-working-with-codeql-packs#creating-a-codeql-pack>`__
+* `Modifying an existing legacy QL pack to create a CodeQL pack <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-and-working-with-codeql-packs#modifying-an-existing-legacy-ql-pack-to-create-a-codeql-pack>`__
+* `Adding and installing dependencies to a CodeQL pack <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-and-working-with-codeql-packs#adding-and-installing-dependencies-to-a-codeql-pack>`__
+* `Customizing a downloaded CodeQL pack <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-and-working-with-codeql-packs#customizing-a-downloaded-codeql-pack>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/creating-codeql-databases.rst b/docs/codeql/codeql-cli/creating-codeql-databases.rst
index 9bc77943fbca..be57b0827589 100644
--- a/docs/codeql/codeql-cli/creating-codeql-databases.rst
+++ b/docs/codeql/codeql-cli/creating-codeql-databases.rst
@@ -6,4 +6,19 @@ Creating CodeQL databases
 .. pull-quote:: 
   This article was moved to "`Creating CodeQL databases <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `Running codeql database create <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#running-codeql-database-create>`__
+* `Progress and results <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#progress-and-results>`__
+* `Creating databases for non-compiled languages <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#creating-databases-for-non-compiled-languages>`__
+      * `JavaScript and TypeScript <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#javascript-and-typescript>`__
+      * `Python <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#python>`__
+      * `Ruby <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#ruby>`__
+* `Creating databases for compiled languages <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#creating-databases-for-compiled-languages>`__
+    * `Detecting the build system <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#detecting-the-build-system>`__
+    * `Specifying build commands <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#specifying-build-commands>`__
+    * `Using indirect build tracing <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#using-indirect-build-tracing>`__
+    * `Example of creating a CodeQL database using indirect build tracing <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#example-of-creating-a-codeql-database-using-indirect-build-tracing>`__
+* `Downloading databases from GitHub.com <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-databases#downloading-databases-from-githubcom>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/creating-codeql-query-suites.rst b/docs/codeql/codeql-cli/creating-codeql-query-suites.rst
index 08e5c3d75711..fc1980970bb3 100644
--- a/docs/codeql/codeql-cli/creating-codeql-query-suites.rst
+++ b/docs/codeql/codeql-cli/creating-codeql-query-suites.rst
@@ -6,4 +6,16 @@ Creating CodeQL query suites
 .. pull-quote:: 
   This article was moved to "`Creating CodeQL query suites <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `Locating queries to add to a query suite <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites#locating-queries-to-add-to-a-query-suite>`__
+* `Filtering the queries in a query suite <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites#filtering-the-queries-in-a-query-suite>`__
+    * `Examples of filtering which queries are run <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites#examples-of-filtering-which-queries-are-run>`__
+* `Reusing existing query suite definitions <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites#reusing-existing-query-suite-definitions>`__
+    * `Reusability Examples <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites#reusability-examples>`__
+* `Naming a query suite <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites#naming-a-query-suite>`__
+* `Saving a query suite <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites#saving-a-query-suite>`__
+* `Specifying well-known query suites <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites#specifying-well-known-query-suites>`__ 
+* `Using query suites with CodeQL <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/creating-codeql-query-suites#using-query-suites-with-codeql>`__  
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/exit-codes.rst b/docs/codeql/codeql-cli/exit-codes.rst
index 1c01dd45706f..2bb115e6d812 100644
--- a/docs/codeql/codeql-cli/exit-codes.rst
+++ b/docs/codeql/codeql-cli/exit-codes.rst
@@ -6,4 +6,4 @@ Exit codes
 .. pull-quote:: 
   This article was moved to "`Exit codes <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/exit-codes>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
diff --git a/docs/codeql/codeql-cli/extractor-options.rst b/docs/codeql/codeql-cli/extractor-options.rst
index a9b67c19a0d7..76728426ffdb 100644
--- a/docs/codeql/codeql-cli/extractor-options.rst
+++ b/docs/codeql/codeql-cli/extractor-options.rst
@@ -6,4 +6,10 @@ Extractor options
 .. pull-quote:: 
   This article was moved to "`Extractor options <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/extractor-options>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `About extractor options <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/extractor-options#about-extractor-options>`__
+* `Setting extractor options with the CodeQL CLI <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/extractor-options#setting-extractor-options-with-the-codeql-cli>`__
+* `Setting extractor options from files <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/extractor-options#setting-extractor-options-from-files>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/getting-started-with-the-codeql-cli.rst b/docs/codeql/codeql-cli/getting-started-with-the-codeql-cli.rst
index 70c260890034..1d2a37957e52 100644
--- a/docs/codeql/codeql-cli/getting-started-with-the-codeql-cli.rst
+++ b/docs/codeql/codeql-cli/getting-started-with-the-codeql-cli.rst
@@ -6,4 +6,20 @@ Getting started with the CodeQL CLI
 .. pull-quote:: 
   This article was moved to "`Getting started with the CodeQL CLI <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `Setting up the CodeQL CLI <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#setting-up-the-codeql-cli>`__
+    * `1. Download the CodeQL CLI zip package <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#1-download-the-codeql-cli-zip-package>`__
+    * `2. Extract the zip archive <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#2-extract-the-zip-archive>`__
+    * `3. Launch codeql <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#3-launch-codeql>`__
+    * `4. Verify your CodeQL CLI setup <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#4-verify-your-codeql-cli-setup>`__
+* `Checking out the CodeQL source code directly <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#checking-out-the-codeql-source-code-directly>`__
+    * `1. Download the CodeQL CLI zip <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#1-download-the-codeql-cli-zip>`__
+    * `2. Create a new CodeQL directory <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#2-create-a-new-codeql-directory>`__
+    * `3. Obtain a local copy of the CodeQL queries <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#3-obtain-a-local-copy-of-the-codeql-queries>`__
+    * `4. Extract the zip archive <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#4-extract-the-zip-archive>`__
+    * `5. Launch codeql <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#5-launch-codeql>`__
+    * `6. Verify your CodeQL CLI setup <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#6-verify-your-codeql-cli-setup>`__
+* `Using two versions of the CodeQL CLI <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/getting-started-with-the-codeql-cli#using-two-versions-of-the-codeql-cli>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/publishing-and-using-codeql-packs.rst b/docs/codeql/codeql-cli/publishing-and-using-codeql-packs.rst
index ad025d7d480c..9eefe82cf6f1 100644
--- a/docs/codeql/codeql-cli/publishing-and-using-codeql-packs.rst
+++ b/docs/codeql/codeql-cli/publishing-and-using-codeql-packs.rst
@@ -6,4 +6,14 @@ Publishing and using CodeQL packs
 .. pull-quote:: 
   This article was moved to "`Publishing and using CodeQL packs <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/publishing-and-using-codeql-packs>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `Configuring the qlpack.yml file before publishing <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/publishing-and-using-codeql-packs#configuring-the-qlpackyml-file-before-publishing>`__
+* `Running codeql pack publish <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/publishing-and-using-codeql-packs#running-codeql-pack-publish>`__
+* `Running codeql pack download <scope>/<pack> <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/publishing-and-using-codeql-packs#running-codeql-pack-download-scopepack>`__
+* `Using a CodeQL pack to analyze a CodeQL database <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/publishing-and-using-codeql-packs#using-a-codeql-pack-to-analyze-a-codeql-database>`__
+* `About CodeQL pack compatibility <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/publishing-and-using-codeql-packs#about-codeql-pack-compatibility>`__
+* `Working with CodeQL packs on GitHub Enterprise Server <https://docs.github.com/en/enterprise-server@3.7/code-security/codeql-cli/using-the-codeql-cli/publishing-and-using-codeql-packs#working-with-codeql-packs-on-github-enterprise-server>`__
+* `Authenticating to GitHub Container registries <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/publishing-and-using-codeql-packs#authenticating-to-github-container-registries>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/query-reference-files.rst b/docs/codeql/codeql-cli/query-reference-files.rst
index e468b1448a76..1958f0c34ea1 100644
--- a/docs/codeql/codeql-cli/query-reference-files.rst
+++ b/docs/codeql/codeql-cli/query-reference-files.rst
@@ -6,4 +6,9 @@ Query reference files
 .. pull-quote:: 
   This article was moved to "`Query reference files <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/query-reference-files>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `Defining a query reference file <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/query-reference-files#defining-a-query-reference-file>`__
+    * `Example <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/query-reference-files#example>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/sarif-output.rst b/docs/codeql/codeql-cli/sarif-output.rst
index 64b659a1afaa..7a134f32ace9 100644
--- a/docs/codeql/codeql-cli/sarif-output.rst
+++ b/docs/codeql/codeql-cli/sarif-output.rst
@@ -6,4 +6,26 @@ SARIF output
 .. pull-quote:: 
   This article was moved to "`CodeQL CLI SARIF output <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `SARIF specification and schema <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#sarif-specification-and-schema>`__
+* `Change notes <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#change-notes>`__
+    * `Changes between versions <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#changes-between-versions>`__
+    * `Future changes to the output <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#future-changes-to-the-output>`__
+* `Generated SARIF objects <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#generated-sarif-objects>`__
+    * `sarifLog object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#sariflog-object>`__
+    * `run object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#run-object>`__
+    * `tool object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#tool-object>`__
+    * `toolComponent object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#toolcomponent-object>`__
+    * `reportingDescriptor object for rule <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#reportingdescriptor-object-for-rule>`__
+    * `artifact object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#artifact-object>`__
+    * `artifactLocation object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#artifactlocation-object>`__
+    * `result object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#result-object>`__
+    * `location object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#location-object>`__
+    * `physicalLocation object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#physicallocation-object>`__
+    * `region object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#region-object>`__
+    * `codeFlow object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#codeflow-object>`__
+    * `threadFlow object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#threadflow-object>`__
+    * `threadFlowLocation object <https://docs.github.com/en/code-security/codeql-cli/codeql-cli-reference/sarif-output#threadflowlocation-object>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/specifying-command-options-in-a-codeql-configuration-file.rst b/docs/codeql/codeql-cli/specifying-command-options-in-a-codeql-configuration-file.rst
index 2c2a920fce20..5b88acb86a82 100644
--- a/docs/codeql/codeql-cli/specifying-command-options-in-a-codeql-configuration-file.rst
+++ b/docs/codeql/codeql-cli/specifying-command-options-in-a-codeql-configuration-file.rst
@@ -6,4 +6,9 @@ Specifying command options in a CodeQL configuration file
 .. pull-quote:: 
   This article was moved to "`Specifying command options in a CodeQL configuration file <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/specifying-command-options-in-a-codeql-configuration-file>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+  .. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `Using a CodeQL configuration file <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/specifying-command-options-in-a-codeql-configuration-file#using-a-codeql-configuration-file>`__
+    * `Examples <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/specifying-command-options-in-a-codeql-configuration-file#examples>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/testing-custom-queries.rst b/docs/codeql/codeql-cli/testing-custom-queries.rst
index 3177a9b6ec29..65560597d784 100644
--- a/docs/codeql/codeql-cli/testing-custom-queries.rst
+++ b/docs/codeql/codeql-cli/testing-custom-queries.rst
@@ -6,4 +6,14 @@ Testing custom queries
 .. pull-quote:: 
   This article was moved to "`Testing custom queries <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `Setting up a test CodeQL pack for custom queries <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#setting-up-a-test-codeql-pack-for-custom-queries>`__
+* `Setting up the test files for a query <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#setting-up-the-test-files-for-a-query>`__
+* `Running codeql test run <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#running-codeql-test-run>`__
+* `Example <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#example>`__
+    * `Prepare a query and test files <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#prepare-a-query-and-test-files>`__
+    * `Execute the test <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#execute-the-test>`__
+    * `View the query test output <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#view-the-query-test-output>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/testing-query-help-files.rst b/docs/codeql/codeql-cli/testing-query-help-files.rst
index 0a5277bfc282..01f5521f8066 100644
--- a/docs/codeql/codeql-cli/testing-query-help-files.rst
+++ b/docs/codeql/codeql-cli/testing-query-help-files.rst
@@ -6,4 +6,10 @@ Testing query help files
 .. pull-quote:: 
   This article was moved to "`Testing query help files <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-query-help-files>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `Prerequisites <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-query-help-files#prerequisites>`__
+* `Running codeql generate query-help <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-query-help-files#running-codeql-generate-query-help>`__
+* `Results <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-query-help-files#results>`__
\ No newline at end of file
diff --git a/docs/codeql/codeql-cli/using-custom-queries-with-the-codeql-cli.rst b/docs/codeql/codeql-cli/using-custom-queries-with-the-codeql-cli.rst
index eb096c8033d4..393a94f7ec92 100644
--- a/docs/codeql/codeql-cli/using-custom-queries-with-the-codeql-cli.rst
+++ b/docs/codeql/codeql-cli/using-custom-queries-with-the-codeql-cli.rst
@@ -6,4 +6,11 @@ Using custom queries with the CodeQL CLI
 .. pull-quote:: 
   This article was moved to "`Using custom queries with the CodeQL CLI <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/using-custom-queries-with-the-codeql-cli>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
   
-  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
\ No newline at end of file
+  .. include:: ../reusables/codeql-cli-articles-migration-note.rst
+
+.. include:: ../reusables/codeql-cli-migration-toc-note.rst
+
+* `Writing a valid query <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/using-custom-queries-with-the-codeql-cli#writing-a-valid-query>`__
+* `Including query metadata <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/using-custom-queries-with-the-codeql-cli#including-query-metadata>`__
+* `Packaging custom QL queries <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/using-custom-queries-with-the-codeql-cli#packaging-custom-ql-queries>`__
+* `Contributing to the CodeQL repository <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/using-custom-queries-with-the-codeql-cli#contributing-to-the-codeql-repository>`__
\ No newline at end of file
diff --git a/docs/codeql/reusables/codeql-cli-migration-toc-note.rst b/docs/codeql/reusables/codeql-cli-migration-toc-note.rst
new file mode 100644
index 000000000000..9e13f93567d9
--- /dev/null
+++ b/docs/codeql/reusables/codeql-cli-migration-toc-note.rst
@@ -0,0 +1 @@
+If you want to go to a specific subsection in the new location, see the TOC links below.
\ No newline at end of file