scripts/generate-docs does not produce consistent results

The following discussion from !7792 (merged) should be addressed:

• @mkaeppler started a discussion: (+5 comments)

  @sxuereb Would you know why make generate keeps outputting a diff for things I never touched? 🤔

  [16:46:32] fsrv: ~/Work/runbooks  g st
   mk-duo-runbook*
  
  On branch mk-duo-runbook
  Your branch and 'origin/mk-duo-runbook' have diverged,
  and have 58 and 5 different commits each, respectively.
    (use "git pull" if you want to integrate the remote branch with yours)
  
  Changes not staged for commit:
    (use "git add <file>..." to update what will be committed)
    (use "git restore <file>..." to discard changes in working directory)
  	modified:   docs/about/README.md
  	modified:   docs/ai-gateway/README.md
  	modified:   docs/api/README.md
  	modified:   docs/cloudflare/README.md
  	modified:   docs/console/README.md
  	modified:   docs/consul/README.md
  	modified:   docs/customersdot/README.md
  	modified:   docs/frontend/README.md
  	modified:   docs/git/README.md
  	modified:   docs/gitaly/README.md
  	modified:   docs/kube/README.md
  	modified:   docs/mailgun/README.md
  	modified:   docs/omnibus/README.md
  	modified:   docs/patroni-ci/README.md
  	modified:   docs/patroni/README.md
  	modified:   docs/pgbouncer/README.md
  	modified:   docs/redis-sessions/README.md
  	modified:   docs/redis-sidekiq/README.md
  	modified:   docs/redis-tracechunks/README.md
  	modified:   docs/redis/README.md
  	modified:   docs/registry/README.md
  	modified:   docs/search/README.md
  	modified:   docs/sidekiq/README.md
  	modified:   docs/thanos/README.md
  	modified:   docs/vault/README.md
  	modified:   docs/version/README.md
  	modified:   docs/web/README.md

  When I look at these diffs, it's mostly reordering certain links?