feat: reduce clone/fetch size when building docs PRs

[kruskall]

do not fetch tags (they are unused)

use a treeless clone of the target branch instead of cloning the default branch: the initial clone of the default branch is unused, we are only interested in the target branch to compare the diff with the PR.

[github-actions]

A documentation preview will be available soon.

• 🔨 Buildkite builds
• 📚 HTML diff
• 📙 Preview page

Request a new doc build by commenting

• Rebuild this PR: run docs-build
• Rebuild this PR and all Elastic docs: run docs-build rebuild

_{run docs-build is much faster than run docs-build rebuild. A rebuild should only be needed in rare situations.}

_{If your PR continues to fail for an unknown reason, the doc build pipeline may be broken. Elastic employees can check the pipeline status here.}

[bmorelli25]

Thanks for the contribution! LGTM. I'll wait to merge this until tomorrow or Wednesday when I know I'll be around for a few hours to make sure PR CI is running smoothly.

[bmorelli25]

I might have to revert this. A number of PRs are failing with:

2024-10-30 09:42:30 PDT | INFO:build_docs:---------
-- | --
  | 2024-10-30 09:42:30 PDT | INFO:build_docs: -                             Kibana Guide: Merging the subbed dir for [kibana][main][:(glob)src/**/*.asciidoc] into the last successful build.
  | 2024-10-30 09:42:34 PDT | INFO:build_docs: -                             Kibana Guide: Failed to merge the subbed dir for [kibana][main][:(glob)src/**/*.asciidoc] into the last successful build:
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:Error executing: git merge -m merge dbe7f54dd7beaf10f7e059c06d98970a8eae8b4a
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:---out---
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:Auto-merging yarn.lock
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:CONFLICT (content): Merge conflict in yarn.lock
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:Auto-merging src/dev/license_checker/config.ts
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:CONFLICT (content): Merge conflict in src/dev/license_checker/config.ts
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:Auto-merging package.json
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:CONFLICT (content): Merge conflict in package.json
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:Automatic merge failed; fix conflicts and then commit the result.
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:
  | 2024-10-30 09:42:34 PDT | INFO:build_docs:---err---

edit: link to one of these failures

[bmorelli25]

Hmm. Seems to only be Kibana PRs that are failing.

[kruskall]

😭

[bmorelli25]

Not sure why only Kibana PRs are failing, but they all are failing with the same error. I reverted in #3098.

[kruskall]

Not sure why only Kibana PRs are failing

kibana is excluded from the switch case which means the script will only fetch the latest commit in the PR without fetching the whole history (because it doesn't need to do the diff).
I'm not sure why building the docs fail (probably using some git command that requires the whole history which imo is bad) but I guess this is an opportunity to improve the build process :D