fix broken links: change from .txt to .adoc

[Botato300]

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

[dscho]

Looks correct!

I will need to re-run the GitHub workflow to re-generate the manual pages with this change. However, the result would conflict with #2007 at the moment, therefore I will hold off until that PR is merged, then go ahead and integrate this here PR so that the results will not conflict.

[dscho]

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 :-(

[To1ne]

change from .txt to .adoc

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

[dscho]

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:

git-scm.com/script/update-docs.rb

Line 598 in e3e589e

if !File.exist?(doc_path)

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.