Skip to content

Conversation

@harshil21
Copy link
Member

@harshil21 harshil21 commented Jun 13, 2025

Search as you type has not been working for a long time, we should probably enable the rtd addons - #4387

There are also many warnings while building docs, looks like the strict flag doesn't work? This PR fixes a few at least, I can't seem to figure out why the others fail...

Also fixes a few docs, where methods of the object class were listed out.

@harshil21 harshil21 requested a review from Copilot June 13, 2025 09:49
@harshil21 harshil21 added the ⚙️ documentation affected functionality: documentation label Jun 13, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR removes the outdated furo-sphinx-search extension and cleans up related directives in the documentation to address build warnings and prepare for RTD search addons.

  • Remove furo-sphinx-search dependency from pyproject.toml
  • Drop sphinx_search.extension from conf.py
  • Remove obsolete :inherited-members: TelegramObject directives in three RST files

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file
File Description
pyproject.toml Removed furo-sphinx-search from the docs dependencies
docs/source/conf.py Deleted sphinx_search.extension from the extensions list
docs/source/telegram.transactionpartner.rst Removed :inherited-members: TelegramObject
docs/source/telegram.startransactions.rst Removed :inherited-members: TelegramObject
docs/source/telegram.startransaction.rst Removed :inherited-members: TelegramObject
Comments suppressed due to low confidence (2)

docs/source/conf.py:53

  • Since furo-sphinx-search was removed, add and configure the ReadTheDocs search extension (e.g., readthedocs-search or enable sphinx_rtd_theme’s search) so that full-text search is restored.
    "sphinx_search.extension",

pyproject.toml:118

  • Consider adding a CI step that builds the documentation and fails on warnings or errors, ensuring future changes don’t reintroduce broken extensions or stale directives.
"furo-sphinx-search @ git+https://github.com/harshil21/furo-sphinx-search@v0.2.0.1",

@harshil21 harshil21 changed the base branch from master to doc-fixes June 17, 2025 10:44
@harshil21 harshil21 changed the title Remove furo-sphinx-search Remove furo-sphinx-search, and fix some docs Jun 17, 2025
@harshil21 harshil21 requested a review from Bibo-Joshi June 18, 2025 14:46
@Bibo-Joshi Bibo-Joshi merged commit 4c61c4e into doc-fixes Jun 19, 2025
23 of 24 checks passed
@Bibo-Joshi Bibo-Joshi deleted the rm-furo-sphinx-search branch June 19, 2025 18:35
@github-actions github-actions bot locked and limited conversation to collaborators Jun 27, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

⚙️ documentation affected functionality: documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants