[assembler] Pages not found when built locally

[colleenmcginnis]

Describe the bug

First reported in #780 (comment)

The global navigation builds without errors and all items are present, but clicking on some links results in "page can't be found".

page-not-found.mov

Initially thought this was caused by the lack of toc_max_depth: 2 in the elasticsearch repo because most of the links with this problem were from the elasticsearch repo. However, I'm still seeing this problem even after merging elastic/elasticsearch#125509.

After poking around a bit, I noticed that in .artifacts/assembly/docs some of the sub directory names look like part of the name is cut off at the beginning, but I couldn't deduce what the pattern was. I'm not sure if this is just something with my local setup or if this happens for others.

But, if you do visit the incorrect path (for example, http://localhost:4000/docs/reference/elasticsearch/-apis/) the page is there, but it doesn't have the global nav.

Expected behavior

I expect that I can visit these pages by clicking the links in the global nav.

Steps to reproduce

1. Build docs-builder and docs-assembler locally.
2. Run docs-assembler repo clone-all.
3. Run docs-assembler repo build-all.
4. Run docs-builder serve-static.
5. Go to http://localhost:4000/docs/reference/elasticsearch/
6. Try clicking the Configuration link in the global nav.
   • Do you get page not found?
   • Is there content at http://localhost:4000/docs/reference/elasticsearch/onfiguration-reference/?
7. Go back and try clicking JVM settings in the global nav.
   • Does the page render as expected?

Tooling

• docs-builder
• migration tooling
• I'm not sure