Skip to content
This repository was archived by the owner on Apr 9, 2025. It is now read-only.

Add a note about the deprecation of this extension #337

Merged

Conversation

agriyakhetarpal
Copy link
Contributor

@agriyakhetarpal agriyakhetarpal commented Apr 9, 2025

Description

See #312

This PR updates the README to reflect the current deprecated status of this Sphinx extension, and advises users to switch to the Read the Docs addons.

Unfortunately, the README is in reStructuredText, for which GitHub's admonitions do not render properly. There has been a workaround that no longer works due to this issue: github/markup#1682.

I tried to use raw HTML to render the "Warning" as a heading in yellow ochre, but it didn't work that way – the only way to make it more prominent is to convert this document to Markdown.


📚 Documentation preview 📚: https://sphinx-hoverxref--337.org.readthedocs.build/en/337/

@agriyakhetarpal
Copy link
Contributor Author

How it renders on GitHub (not ideal, I'd say): https://github.com/agriyakhetarpal/sphinx-hoverxref/tree/note/deprecated-status-of-repository

Copy link
Member

@humitos humitos left a comment

Choose a reason for hiding this comment

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

Looks good to me! Thanks

@humitos humitos merged commit 96ff768 into readthedocs:main Apr 9, 2025
2 of 6 checks passed
@agriyakhetarpal agriyakhetarpal deleted the note/deprecated-status-of-repository branch April 9, 2025 09:59
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants