git-scm.com icon indicating copy to clipboard operation
git-scm.com copied to clipboard

fix broken links: change from .txt to .adoc

Open Botato300 opened this issue 7 months ago • 2 comments

Changes

  • Just change from .txt to .adoc

Context

Some links like “/docs/howto/update-hook-example” redirected to URLs ending in .txt, which no longer exist. They now redirect to the same URLs ending in .adoc. Issue associated: #2006

Botato300 avatar May 20 '25 14:05 Botato300

I will need to re-run the GitHub workflow to re-generate the manual pages with this change.

For the record, I did that a couple of days ago, but despite my local confirmation that the patch works, the workflow did not result in any changes :-(

dscho avatar May 26 '25 08:05 dscho

change from .txt to .adoc

This gift keeps on giving. I'll try to have a look tomorrow.

To1ne avatar Jun 03 '25 09:06 To1ne

I will need to re-run the GitHub workflow to re-generate the manual pages with this change.

For the record, I did that a couple of days ago, but despite my local confirmation that the patch works, the workflow did not result in any changes :-(

I figured it out. The problem is this line: https://github.com/git/git-scm.com/blob/e3e589e185335fe5d965c36a65321b322da2e1bd/script/update-docs.rb#L598

That's the line responsible for not re-generating the /docs/howto/* files: It first verifies the absence of the static file. But that file already exists, so the script thinks there is nothing to do anymore.

dscho avatar Jul 02 '25 18:07 dscho