Allow specifying custom path locally in assembler.yml

[Mpdreamz]

You may now set path locally in assembler.yml to point to a local checkout of a documentation set to ease validation changes on the asssembled build.

references:
  # @elastic/ingest-docs
  apm-server:
     path: <FULL_PATH_TO_LOCAL_CHECKOUT>
  apm-agent-android:

This is not allowed on CI and path will be cleared automatically if its set.

Integration tests with local docs-builder docs

This now also re-enables our integration tests and it uses this feature to inject:

• The local docs folder from docs-builder as path in assembler.yml (and unsetting skip.
• Adds it to the navigation (at the end of references).

This allows our CI to validate changes to docset.yml to our assemble process.

Updates to our aspire setup.

Our Aspire set up has now moved to a more logical place and makes it dead easy to start all services locally:

dotnet run --project aspire

Or if you want faster local builds you can do:

dotnet run --project aspire -- --skip-private-repositories --asume-cloned

I added a more in depth readme to document the why and how of our aspire setup.

https://github.com/elastic/docs-builder/blob/e37dbfd50b04ffdcaff6481bc98f47008bfeb034/aspire/README.md

[github-actions]

🔍 Preview links for changed docs

• aspire/README.md

[cotti]

LGTM!

Gonna be interesting to see how much more we can stretch Aspire in the future.

[theletterf]

Sweet!