[docs][meta] Migrate APM Server documentation to asciidoctor

[bmorelli25]

Doc repo PRs

• APM Agents - [docs] Migrate APM agent documentation to asciidoctor apm#58
• APM Overview - Switch APM Overview to Asciidoctor docs#733
• Server reference - Switch APM Server to Asciidoctor docs#1083

APM Server

✅ indicates the branch builds with asciidoctor.

• master - Docs: Asciidoctor compatibility #2567, [docs] Sync beats documentation #2542, [docs] Add links to rum configs #2603, [docs] Asciidoctor built HTML fixes #2649
• 7.x - Docs: Asciidoctor compatibility (7.x) (#2567) #2568, [docs] Add links to rum configs #2604, [docs][7.x] Sync beats documentation (#2542) #2606, [7.x][docs] Asciidoctor built HTML fixes (#2649) #2654
• 7.3 - Docs: Asciidoctor compatibility (7.3) (#2567) #2569, [docs] Add links to rum configs #2605, [docs][7.3] Sync beats documentation (#2542) #2607, [7.3][docs] Asciidoctor built HTML fixes #2649 #2650
• 7.2 - Docs: Asciidoctor compatibility (7.2) (#2567) #2570, [docs][7.2] Fix fields.asciidoc for asciidoctor #2578, [7.2][docs] Asciidoctor built HTML fixes (#2649) #2653
• 7.1 - Docs: Asciidoctor compatibility (7.1) (#2567) #2571, [docs][7.1] Fix fields.asciidoc for asciidoctor #2583, [docs][7.1] Remove arbitrary python expressions #2595, [7.1][docs] Asciidoctor built HTML fixes #2649 #2651
• 7.0 - Docs: Asciidoctor compatibility (7.0) (#2567) #2572, [docs][7.0] Fix fields.asciidoc for asciidoctor #2584, [docs][7.0] Remove arbitrary python expressions #2596, [7.0][docs] Asciidoctor built HTML fixes #2649 #2652
• 6.8 - Docs: Asciidoctor compatibility (6.8) (#2567) #2573, [docs][6.8] Fix Asciidoctor build errors #2586, [docs][6.8] Remove arbitrary python expressions #2600, [6.8][docs] Asciidoctor diff fixes #2637
• 6.7 - Docs: Asciidoctor compatibility (6.7) (#2567) #2574, [docs][6.7] Fix Asciidoctor build errors #2587, [docs][6.7] Remove arbitrary python expressions #2601, [6.7][docs] Asciidoctor diff fixes (#2637) #2641
• 6.6 - Docs: Asciidoctor compatibility (6.6) (#2567) #2575, [docs][6.6] Fix Asciidoctor build errors #2590, [docs][6.6] Remove arbitrary python expressions #2602, [6.6][docs] Asciidoctor diff fixes (#2637) #2638
• 6.5 - Docs: Asciidoctor compatibility (6.5) (#2567) #2576, [docs][6.5] Fix Asciidoctor build errors #2591, [docs][6.5] Remove arbitrary python expressions #2613, [6.5][docs] Asciidoctor diff fixes (#2637) #2639
• 6.4 - [docs][6.4] Fix Asciidoctor build errors #2592, [docs][6.4] Remove arbitrary python expressions #2610, [6.4][docs] Asciidoctor diff fixes (#2637) #2640
• 6.3 - [docs][6.3] Fix Asciidoctor build errors #2593, [docs][6.3] Remove arbitrary python expressions #2611, [6.3][docs] Asciidoctor diff fixes #2642
• 6.2 - [docs][6.2] Fix Asciidoctor build errors #2594, [docs][6.2] Remove arbitrary python expressions #2612, [6.2][docs] Asciidoctor diff fixes #2643
• 6.1 - OK
• 6.0 - OK

Other problems

• Broken RUM links - [docs] Update link to APM server apm-agent-rum-js#387, [docs][4.x] Update link to APM server  apm-agent-rum-js#388
• Broken Cloud links - https://github.com/elastic/cloud/pull/38301, https://github.com/elastic/cloud/pull/38372
• Follow up with redirects for APM RUM Agent
• Delete built docs to js-base which cause the unfixable error seen here Switch APM Server to Asciidoctor docs#1083 (comment). Delete old APM JS Agent documentation docs#1104
• Remove the placeholder for the old _literal link in 6a9dcf5.
• Update all build scripts on master. Backport to 7.0. Merge after the switch is made.

Generate a list of changes

cd built-docs
git checkout elastic/docs_1083
git show --name-status

• Create a list of changes: https://gist.github.com/bmorelli25/4e4b0b6fbc198f3578b5965219807732
• Confirm no files moved that weren't supposed to.

Generate a diff

Takes about 90 mins

for file in $(find html/en/apm/server | grep \.html | sort); do echo $file; docker run -it --rm --user 1000:1000 -v $GIT_HOME/docs:/docs_build:cached -v $(pwd):/work --security-opt seccomp=unconfined docker.elastic.co/docs/build:1 bash -c "cd /work && /docs_build/integtest/html_diff <(git show HEAD~1:$file) $file"; done | tee diff

• First diff: docs: asciidoctor diff #2620 ~25,000 lines
• Second diff: https://gist.github.com/bmorelli25/1386f5666494e5b1a6624971ac39e7d3 ~22,000 lines
• Diff good?

---

cc @dedemorton / @nik9000 -- may be helpful for beats 🤷‍♂

[bmorelli25]

🎉 The first list of changes is ready! It's...big. Edit: it's way too big for a comment. Moved to gist: https://gist.github.com/bmorelli25/4e4b0b6fbc198f3578b5965219807732

[bmorelli25]

As of elastic/built-docs@27c6d59, APM Server documentation now builds with Asciidoctor.