Skip to content

doc: fix broken Transifex URLs across release notes and config#1231

Merged
achow101 merged 2 commits intobitcoin-core:masterfrom
Bortlesboat:fix-transifex-urls
Apr 9, 2026
Merged

doc: fix broken Transifex URLs across release notes and config#1231
achow101 merged 2 commits intobitcoin-core:masterfrom
Bortlesboat:fix-transifex-urls

Conversation

@Bortlesboat
Copy link
Copy Markdown
Contributor

@Bortlesboat Bortlesboat commented Mar 23, 2026

All transifex.com links in release notes and _config.yml currently return 404. Transifex migrated to explore.transifex.com.

This PR updates all affected files:

  • www.transifex.com/projects/p/bitcoin/explore.transifex.com/bitcoin/bitcoin/
  • www.transifex.com/bitcoin/bitcoin/explore.transifex.com/bitcoin/bitcoin/
  • www.transifex.com/bitcoincore/bitcoincoreorgexplore.transifex.com/bitcoin/bitcoin/

Rebased version of #1155, which has had merge conflicts since June 2025. Credit to azuchi for identifying the issue.

Verified: old URLs return HTTP 404, new URL returns HTTP 200.

Copy link
Copy Markdown

@hodlinator hodlinator left a comment

Choose a reason for hiding this comment

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

ACK b4e8e12

Same file changes as in #1228 (review).

Copy link
Copy Markdown
Contributor

@murchandamus murchandamus left a comment

Choose a reason for hiding this comment

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

The replacements of

Look good to me.

I think the transifex_url variable: https://www.transifex.com/bitcoincore/bitcoincoreorg should point at the website translation instructions instead. It should perhaps also be renamed as the website doesn’t use transifex.

Comment thread _config.yml Outdated
title: Bitcoin Core
url: https://bitcoincore.org
transifex_url: https://www.transifex.com/bitcoincore/bitcoincoreorg
transifex_url: https://explore.transifex.com/bitcoin/bitcoin/
Copy link
Copy Markdown
Contributor

@murchandamus murchandamus Mar 25, 2026

Choose a reason for hiding this comment

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

My review stumbled over this replacement again. The original link is 404. I can find a "bitcoincore" organisation on Transifex, but it has no projects in it. It looks like the previously linked project was deleted in 2019.

It seems to me that the intent for this variable was to link to the website translation project rather than the client software translation project, but the website doesn’t use Transifex (and never has?). So, I suspect that this link has always been broken.

From a quick grep in the website code, it appears that the variable transifex_url is only used in _includes/istranslated.html for a "not translated" macro.

Assuming my read is right, this variable could be renamed to translation_url (here and in _includes/istranslated.html) and should link instead to the translation instructions for the website:

Suggested change
transifex_url: https://explore.transifex.com/bitcoin/bitcoin/
translation_url: https://github.com/bitcoin-core/bitcoincore.org/blob/master/CONTRIBUTING.md#translation-process

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

You're right, this was for the website project, not Bitcoin Core's. I grepped the repo and transifex_url is only defined in _config.yml — it's not referenced anywhere else. istranslated.html doesn't exist in _includes/ either. Looks like dead code.

Happy to rename it to translation_url pointing at the CONTRIBUTING.md translation process like you suggested, or just remove the variable entirely. What do you think?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Ah right, I had an old branch, and that file was removed in e327ae7 per #1166. I assume the config line can then also be removed, but @achow101 would know better.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This line can be removed.

Comment thread _config.yml Outdated
title: Bitcoin Core
url: https://bitcoincore.org
transifex_url: https://www.transifex.com/bitcoincore/bitcoincoreorg
transifex_url: https://explore.transifex.com/bitcoin/bitcoin/
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
transifex_url: https://explore.transifex.com/bitcoin/bitcoin/

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done, removed the line entirely. Confirmed there are no remaining references to transifex_url anywhere in the repo.

The only consumer (_includes/istranslated.html) was removed in
e327ae7 per bitcoin-core#1166.  No remaining references in the codebase.
Copy link
Copy Markdown

@hodlinator hodlinator left a comment

Choose a reason for hiding this comment

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

re-ACK aa807f3

transifex_url was added in 2bf1bc7 and used in includes/[]istranslated.html which was later removed in e327ae7.

If you happen to re-push, I would switch the order of the commits so you remove transifex_url without first correcting it.

Copy link
Copy Markdown
Contributor

@murchandamus murchandamus left a comment

Choose a reason for hiding this comment

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

I agree that the reversing the order of the two commits would be preferable, but the website code doesn’t get that enough traffic that I’d consider it important.

ACK aa807f3

@achow101
Copy link
Copy Markdown
Member

achow101 commented Apr 9, 2026

ACK aa807f3

@achow101 achow101 merged commit d4f11d0 into bitcoin-core:master Apr 9, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants