DOC: Add cross-links from API reference to user guides for indexing a…

.github/workflows/deprecation-tracking-bot.yml

@@ -38,28 +38,36 @@ jobs:
           })
           linkedPRs = linkedPRs["data"];
           console.log(linkedPRs);
-          if (linkedPRs.length > 0) {
-            console.log("Found linked PR");
-            linkedPR = linkedPRs[0]
-            isDeprecation = false
-            for (label of linkedPR["labels"]) {
-              if (label["name"] == "Deprecate") {
-                isDeprecation = true;
-                break;
+          try {
+            if (linkedPRs.length > 0) {
+              console.log("Found linked PR");
+              linkedPR = linkedPRs[0]
+              isDeprecation = false
+              for (label of linkedPR["labels"]) {
+                if (label["name"] == "Deprecate") {
+                  isDeprecation = true;
+                  break;
+                }
               }
-            }
 
-            PR_NUMBER = linkedPR["number"];
+              PR_NUMBER = linkedPR["number"];
 
-            body += ("\n- [ ] #" + PR_NUMBER);
-            if (isDeprecation) {
-              console.log("PR is a deprecation PR. Printing new body of issue");
-              console.log(body);
-              github.rest.issues.update({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: ${{ env.DEPRECATION_TRACKER_ISSUE }},
-                body: body
-              })
+              body += ("\n- [ ] #" + PR_NUMBER);
+              if (isDeprecation) {
+                console.log("PR is a deprecation PR. Printing new body of issue");
+                console.log(body);
+                github.rest.issues.update({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: ${{ env.DEPRECATION_TRACKER_ISSUE }},
+                  body: body
+                })
+              }
+            }
+          } catch (error) {
+            if (error.status === 404) {
+              core.warning('Resource not found. Please check issue/repo references.');
+            } else {
+              throw error;
             }
           }

.github/workflows/docbuild-and-upload.yml

@@ -57,7 +57,10 @@ jobs:
       run: python web/pandas_web.py web/pandas --target-path=web/build
 
     - name: Build documentation
-      run: doc/make.py --warnings-are-errors
+      run: doc/make.py --warnings-are-errors --num-jobs=1
+
+    - name: Print Sphinx error log
+      run: cat /tmp/sphinx-err-*.log || true
 
     - name: Build the interactive terminal
       working-directory: web/interactive_terminal

doc/source/reference/indexing.rst

@@ -6,9 +6,11 @@
 Index objects
 =============
 
+.. note::
+
+   Looking for a beginner-friendly introduction? See the :doc:`../user_guide/indexing` user guide for indexing and selecting data.
 Index
 -----
-.. currentmodule:: pandas
 
 **Many of these methods or variants thereof are available on the objects
 that contain an index (Series/DataFrame) and those should most likely be
@@ -177,37 +179,36 @@ Numeric Index
 .. _api.categoricalindex:
 
 CategoricalIndex
-----------------
 .. autosummary::
    :toctree: api/
    :template: autosummary/class_without_autosummary.rst
 
-   CategoricalIndex
+   pandas.CategoricalIndex
 
 Categorical components
 ~~~~~~~~~~~~~~~~~~~~~~
 .. autosummary::
    :toctree: api/
 
-   CategoricalIndex.codes
-   CategoricalIndex.categories
-   CategoricalIndex.ordered
-   CategoricalIndex.rename_categories
-   CategoricalIndex.reorder_categories
-   CategoricalIndex.add_categories
-   CategoricalIndex.remove_categories
-   CategoricalIndex.remove_unused_categories
-   CategoricalIndex.set_categories
-   CategoricalIndex.as_ordered
-   CategoricalIndex.as_unordered
+   pandas.CategoricalIndex.codes
+   pandas.CategoricalIndex.categories
+   pandas.CategoricalIndex.ordered
+   pandas.CategoricalIndex.rename_categories
+   pandas.CategoricalIndex.reorder_categories
+   pandas.CategoricalIndex.add_categories
+   pandas.CategoricalIndex.remove_categories
+   pandas.CategoricalIndex.remove_unused_categories
+   pandas.CategoricalIndex.set_categories
+   pandas.CategoricalIndex.as_ordered
+   pandas.CategoricalIndex.as_unordered
 
 Modifying and computations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 .. autosummary::
    :toctree: api/
 
-   CategoricalIndex.map
-   CategoricalIndex.equals
+   pandas.CategoricalIndex.map
+   pandas.CategoricalIndex.equals
 
 .. _api.intervalindex:
 

doc/source/reference/window.rst

@@ -8,6 +8,9 @@ Window
 
 :class:`pandas.api.typing.Rolling` instances are returned by ``.rolling`` calls:
 :func:`pandas.DataFrame.rolling` and :func:`pandas.Series.rolling`.
+.. note::
+
+   Looking for a beginner-friendly introduction? See the :doc:`../user_guide/window` user guide for windowing operations.
 :class:`pandas.api.typing.Expanding` instances are returned by ``.expanding`` calls:
 :func:`pandas.DataFrame.expanding` and :func:`pandas.Series.expanding`.
 :class:`pandas.api.typing.ExponentialMovingWindow` instances are returned by ``.ewm``