mirrorz-org / mirrorz-help

https://help.mirrorz.org
MIT License
57 stars 38 forks source link

feat: add hook for updating documentation automatically #118

Open ricky9w opened 10 months ago

ricky9w commented 10 months ago

特性描述 (Feature Description)

When the content of the mirror repo is updated, the documentation also needs to be updated to match the latest changes in the repository.

Outdated help documents might cause some inconvenience or even mislead users. However, manually updating the documentation can be cumbersome and may not be timely. For example:

Considering that the help documentation is generally structured, creating a hook to automatically update the documentation when the repository content changes seems feasible.

ZenithalHourlyRate commented 10 months ago

For Arch Linux, at the beginning of every month when a new build is released, it is necessary to reset the latest link, among other things.

https://geo.mirror.pkgbuild.com/iso/latest/archlinux-x86_64.iso and https://geo.mirror.pkgbuild.com/images/latest/Arch-Linux-x86_64-cloudimg.qcow2 are symlinks to the latest builds.

eastonman commented 10 months ago

Although writing hooks for updating documents seems feasible, I want to raise a few things.

  1. Document difference between major releases exists, which causes issues whether using scripts or not.
  2. Major version changes are relatively rare.
ricky9w commented 10 months ago

Although writing hooks for updating documents seems feasible, I want to raise a few things.

  1. Document difference between major releases exists, which causes issues whether using scripts or not.

  2. Major version changes are relatively rare.

Maybe take a step back, hooks that just raise notifications, so that maintainers can check if the documentation needs updates in time?