Re: [PATCH 1/5] Docs: changes.rst: rename file and references and add links
From: Randy Dunlap
Date: Wed Aug 12 2026 - 20:06:51 EST
On 8/12/26 6:15 AM, Jonathan Corbet wrote:
> Manuel Ebner <manuelebnerli@xxxxxxxxxxx> writes:
>
>> The current name does not reflect the content of the file, the new name
>> does so. With the links legacy references should continue to work.
>>
>> Change name to software-requirements.rst
>> Change names in Doc/translations/*
>> Add link Doc/process/changes.rst to software-version.rst.
>> Add link Doc/Changes to software-version.rst.
>> Add links in Doc/translations/*
>> Change changes.rst to software-version.rst inChange changes.rst to software-version.rst in
>> Documentation/*
>> README
>> samples/bpf/README.rst
>> scripts/min-tool-version.sh
>> scripts/ver_linux
>>
>> Signed-off-by: Manuel Ebner <manuelebnerli@xxxxxxxxxxx>
>> ---
>> Documentation/Changes | 2 +-
>> Documentation/admin-guide/README.rst | 6 +-
>> Documentation/doc-guide/sphinx.rst | 2 +-
>> Documentation/filesystems/locks.rst | 2 +-
>> Documentation/process/changes.rst | 576 +----------------
>> Documentation/process/howto.rst | 2 +-
>> .../process/software-requirements.rst | 575 +++++++++++++++++
>> .../translations/it_IT/process/changes.rst | 554 +----------------
>> .../translations/it_IT/process/howto.rst | 2 +-
>> .../it_IT/process/software-requirements.rst | 553 +++++++++++++++++
>> .../translations/ja_JP/process/howto.rst | 2 +-
>> .../translations/ko_KR/process/howto.rst | 2 +-
>> .../translations/pt_BR/process/changes.rst | 577 +-----------------
>> .../pt_BR/process/software-requirements.rst | 576 +++++++++++++++++
>> .../translations/sp_SP/process/howto.rst | 2 +-
>> .../translations/zh_CN/admin-guide/README.rst | 6 +-
>> .../translations/zh_CN/process/howto.rst | 2 +-
>> .../translations/zh_TW/admin-guide/README.rst | 6 +-
>> .../translations/zh_TW/process/howto.rst | 2 +-
>> README | 2 +-
>> samples/bpf/README.rst | 2 +-
>> scripts/min-tool-version.sh | 2 +-
>> scripts/ver_linux | 2 +-
>> 23 files changed, 1730 insertions(+), 1727 deletions(-)
>> mode change 100644 => 120000 Documentation/process/changes.rst
>> create mode 100644 Documentation/process/software-requirements.rst
>> mode change 100644 => 120000 Documentation/translations/it_IT/process/changes.rst
>> create mode 100644 Documentation/translations/it_IT/process/software-requirements.rst
>> mode change 100644 => 120000 Documentation/translations/pt_BR/process/changes.rst
>> create mode 100644 Documentation/translations/pt_BR/process/software-requirements.rst
>
> That is a *lot* of churn just because you don't like the name of the
> file. The naming is not perfect - it is the result of decades of
> history - but I think we're better to live with it.
Agreed, let's not change the filename.
--
~Randy