Skip to content

Replace non-functional TOC directive with explanation where to look#39901

Merged
potiuk merged 1 commit intoapache:mainfrom
potiuk:replace-toc-rst-with-explanation
May 28, 2024
Merged

Replace non-functional TOC directive with explanation where to look#39901
potiuk merged 1 commit intoapache:mainfrom
potiuk:replace-toc-rst-with-explanation

Conversation

@potiuk
Copy link
Copy Markdown
Member

@potiuk potiuk commented May 28, 2024

GitHub stopped rendering .. contents:: :local: in their UI and instead opt for expandable table of content that can be shown by clicking an "index" button at the top-right of the page. It's really nice when you know it but it's not easily discoverable. Seems that this is a deliberate choice and there is no going back, so best approach we can do is to explain it to the users by replacing the index with explanation where to look for it.

More details here: github/markup#1798


^ Add meaningful description above
Read the Pull Request Guidelines for more information.
In case of fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
In case of a new dependency, check compliance with the ASF 3rd Party License Policy.
In case of backwards incompatible changes please leave a note in a newsfragment file, named {pr_number}.significant.rst or {issue_number}.significant.rst, in newsfragments.

@potiuk potiuk requested review from ashb and jedcunningham as code owners May 28, 2024 17:53
@potiuk potiuk requested review from Taragolis, jedcunningham, jscheffl and pankajkoti and removed request for ashb and jedcunningham May 28, 2024 17:53
@potiuk potiuk force-pushed the replace-toc-rst-with-explanation branch from dbb5504 to c2d8373 Compare May 28, 2024 17:55
GitHub stopped rendering .. contents:: :local: in their UI and instead
opt for expandable table of content that can be shown by clicking
an "index" button at the top-right of the page. It's really nice
when you know it but it's not easily discoverable. Seems that this
is a deliberate choice and there is no going back, so best approach
we can do is to explain it to the users by replacing the index with
explanation where to look for it.

More details here: github/markup#1798
@potiuk potiuk force-pushed the replace-toc-rst-with-explanation branch from c2d8373 to 2a0d58c Compare May 28, 2024 17:57
@potiuk
Copy link
Copy Markdown
Member Author

potiuk commented May 28, 2024

This is the best I think we can do (unless someone has a better idea):

Before: (see local rendered currently)

image

After:

image

@potiuk potiuk merged commit 1c7fe71 into apache:main May 28, 2024
@potiuk potiuk deleted the replace-toc-rst-with-explanation branch May 28, 2024 18:30
@utkarsharma2 utkarsharma2 added the type:doc-only Changelog: Doc Only label Jun 3, 2024
fdemiane pushed a commit to fdemiane/airflow that referenced this pull request Jun 6, 2024
…pache#39901)

GitHub stopped rendering .. contents:: :local: in their UI and instead
opt for expandable table of content that can be shown by clicking
an "index" button at the top-right of the page. It's really nice
when you know it but it's not easily discoverable. Seems that this
is a deliberate choice and there is no going back, so best approach
we can do is to explain it to the users by replacing the index with
explanation where to look for it.

More details here: github/markup#1798
romsharon98 pushed a commit to romsharon98/airflow that referenced this pull request Jul 26, 2024
…pache#39901)

GitHub stopped rendering .. contents:: :local: in their UI and instead
opt for expandable table of content that can be shown by clicking
an "index" button at the top-right of the page. It's really nice
when you know it but it's not easily discoverable. Seems that this
is a deliberate choice and there is no going back, so best approach
we can do is to explain it to the users by replacing the index with
explanation where to look for it.

More details here: github/markup#1798
@ephraimbuddy ephraimbuddy added changelog:skip Changes that should be skipped from the changelog (CI, tests, etc..) and removed type:doc-only Changelog: Doc Only labels Aug 8, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:dev-tools area:providers changelog:skip Changes that should be skipped from the changelog (CI, tests, etc..)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants