GH-45290: [Docs][Release] Change show_version_warning_banner substitution

[AlenkaF]

Rationale for this change

Stable and dev docs are not correctly updated and need manual intervention due to the upstream change in version warning banner.

What changes are included in this PR?

Another sed substitution is added.

Are these changes tested?

I have tested locally with

> sed -i .bak -e '/^[[:space:]]\{8\}DOCUMENTATION_OPTIONS\.show_version_warning_banner =[[:space:]]*$/{
N
s/^\([[:space:]]\{8\}DOCUMENTATION_OPTIONS\.show_version_warning_banner =[[:space:]]*\)\n[[:space:]]\{12\}false;/\1\n            true;/g
}' index.html

Are there any user-facing changes?

No.

• GitHub Issue: [Docs][Release][Website] Figure out why the version banner code changed in 19.0.0 #45290

[kou]

BTW, why do we need to update DOCUMENTATION_OPTIONS.show_version_warning_banner in HTMLs? It seems that "preferred": true in our versions.json is enough...

arrow/docs/source/_static/versions.json

Line 11 in 8515a08

"preferred": true

https://pydata-sphinx-theme.readthedocs.io/en/stable/user_guide/announcements.html#version-warning-banners

[AlenkaF]

BTW, why do we need to update DOCUMENTATION_OPTIONS.show_version_warning_banner in HTMLs? It seems that "preferred": true in our versions.json is enough...

I think, though I am not 100% sure - would need to check previous discussions, the reason for this is that show_version_warning_banner configuration option was not available for older versions of the docs (also mentioned in the pydata-sphinx-theme announcements link you have shared.

Will check older PRs to see if there is any mention of it.

[AlenkaF]

Hm, I think the reason we need sed for the stable/dev docs is because we simply copy/paste the content where the DOCUMENTATION_OPTIONS.show_version_warning_banner is already set in HTML from the previous release process, see #39737 (comment).

So I think this, unfortunately, has to stay.

I do think we need to update the pin on the theme, though! Will try to work on the issue at the end of this week or in the beginning of next: #39759