From db6e2f183f61af2cb52c03395dcd365fe6b75b41 Mon Sep 17 00:00:00 2001 From: chaitanyakumar-d Date: Thu, 30 Oct 2025 09:57:59 -0500 Subject: [PATCH 1/4] DOC: Add cross-links from API reference to user guides for indexing and windowing --- doc/source/reference/indexing.rst | 4 +++- doc/source/reference/window.rst | 3 +++ 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/doc/source/reference/indexing.rst b/doc/source/reference/indexing.rst index 93f88db0843dc..4760602519a8b 100644 --- a/doc/source/reference/indexing.rst +++ b/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 diff --git a/doc/source/reference/window.rst b/doc/source/reference/window.rst index 80ecf236a0daf..15dbeece9dc60 100644 --- a/doc/source/reference/window.rst +++ b/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`` From d52745feda334dfc0683f96ba37765875ac0c037 Mon Sep 17 00:00:00 2001 From: chaitanyakumar-d Date: Thu, 30 Oct 2025 10:30:49 -0500 Subject: [PATCH 2/4] DOC: Fix autosummary reference for CategoricalIndex to pandas.CategoricalIndex --- doc/source/reference/indexing.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/reference/indexing.rst b/doc/source/reference/indexing.rst index 4760602519a8b..04b1dd28e38f5 100644 --- a/doc/source/reference/indexing.rst +++ b/doc/source/reference/indexing.rst @@ -184,7 +184,7 @@ CategoricalIndex :toctree: api/ :template: autosummary/class_without_autosummary.rst - CategoricalIndex + pandas.CategoricalIndex Categorical components ~~~~~~~~~~~~~~~~~~~~~~ From 9b2bcb205a9c1ea9b4e41d8c9616e08f2fb0000c Mon Sep 17 00:00:00 2001 From: chaitanyakumar-d Date: Thu, 30 Oct 2025 14:31:57 -0500 Subject: [PATCH 3/4] DOC: Fix autosummary reference to pandas.CategoricalIndex for Sphinx build --- .../workflows/deprecation-tracking-bot.yml | 48 +++++++++++-------- .github/workflows/docbuild-and-upload.yml | 5 +- 2 files changed, 32 insertions(+), 21 deletions(-) diff --git a/.github/workflows/deprecation-tracking-bot.yml b/.github/workflows/deprecation-tracking-bot.yml index 68b72d36b4d1a..f325441add5d9 100644 --- a/.github/workflows/deprecation-tracking-bot.yml +++ b/.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; } } diff --git a/.github/workflows/docbuild-and-upload.yml b/.github/workflows/docbuild-and-upload.yml index f7f875de7d93b..e6d531010dc87 100644 --- a/.github/workflows/docbuild-and-upload.yml +++ b/.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 From d425bcdbcb678f055b4522b277474285673f0909 Mon Sep 17 00:00:00 2001 From: chaitanyakumar-d Date: Thu, 30 Oct 2025 14:42:34 -0500 Subject: [PATCH 4/4] DOC: Fix autosummary reference to pandas.CategoricalIndex for Sphinx build --- doc/source/reference/indexing.rst | 27 +++++++++++++-------------- 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/doc/source/reference/indexing.rst b/doc/source/reference/indexing.rst index 04b1dd28e38f5..02d2734c2581e 100644 --- a/doc/source/reference/indexing.rst +++ b/doc/source/reference/indexing.rst @@ -179,7 +179,6 @@ Numeric Index .. _api.categoricalindex: CategoricalIndex ----------------- .. autosummary:: :toctree: api/ :template: autosummary/class_without_autosummary.rst @@ -191,25 +190,25 @@ 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: