Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Remove furo-sphinx-search, and fix some docs #4826

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Jun 19, 2025

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

@Copilot 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/[email protected]",

@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.

2 participants