Re: [PATCH 0/2] Update links of LoongArch ISA Vol1 and ELF psABI

From: Tiezhu Yang
Date: Sun Dec 04 2022 - 20:44:56 EST




On 12/03/2022 06:58 PM, Jonathan Corbet wrote:
Tiezhu Yang <yangtiezhu@xxxxxxxxxxx> writes:

Tiezhu Yang (2):
docs/LoongArch: Update links of LoongArch ISA Vol1 and ELF psABI
docs/zh_CN/LoongArch: Update links of LoongArch ISA Vol1 and ELF psABI

Documentation/loongarch/introduction.rst | 8 ++++----
Documentation/translations/zh_CN/loongarch/introduction.rst | 8 ++++----
2 files changed, 8 insertions(+), 8 deletions(-)

I've applied these - working links are better than broken ones. I
assume, though, that the new URLs, too, will break the next time the
manual is updated? Is there any chance Loongson could provide a stable
URL for the current version of this manual instead?

Thanks,

jon


Here are my thoughts:

(1) Just use the release link without file name, simple and timeless.

https://github.com/loongson/LoongArch-Documentation/releases

(2) Use the online html links, but the Chinese html version of ISA
Vol1 is unavailable now.

https://loongson.github.io/LoongArch-Documentation/LoongArch-Vol1-CN.html (unavailable now)
https://loongson.github.io/LoongArch-Documentation/LoongArch-Vol1-EN.html

https://loongson.github.io/LoongArch-Documentation/LoongArch-ELF-ABI-CN.html
https://loongson.github.io/LoongArch-Documentation/LoongArch-ELF-ABI-EN.html

(3) As Ruoyao said, use a link with tag name instead of "latest",
may be outdated but always valid.

https://github.com/loongson/LoongArch-Documentation/releases/download/2022.08.12/LoongArch-Vol1-v1.02-CN.pdf

Thanks,
Tiezhu