Doc: Publish Logstash docs from non-main branch

[karenzone]

Related:

• https://github.com/elastic/docs-projects/issues/490
• Prior art: https://github.com/elastic/docs-projects/issues/491

This is the process we'd follow to start publishing from the 9.0 branch.

Prep

Make sure all relevant docs updates have been backported to 9.0.

Configure

• Open a PR updating CI triggers (docs) (Docs: Ensure docs are built for version branches #17700)
  • Doc: Add docs-build.yml for 9.0 #17705
• Merge to main and the intended version branch (9.0)
• Ensure the docs build
  • https://docs-v3-preview.elastic.dev/elastic/logstash/tree/9.0/reference/. 🎉
• Open a PR updating assembler.yml (Publish logstash docs from the 9.0 branch docs-builder#1346):

  logstash:
      current: "9.0"
      next: main

  • Add the ci label to the PR.
  • Confirm that the 9.0 branch is publishing to the link service: https://elastic-docs-link-index.s3.us-east-2.amazonaws.com/elastic/logstash/9.0/links.json
  • Rerun ci / validate-assembler (pull_request) in the PR
  • Merge when docs eng approves and all checks pass
• Docs eng release docs-builder
• Verify publishing from correct branch

[colleenmcginnis]

I added a couple more items/subitems to the list based on my experience with the beats repo. (Trying to help out our future selves who might do this for other repos!)

[karenzone]

@colleenmcginnis, I added a validation step and looked here:

Then I noticed that all docs (including Beats) are set to 9.0+. Should I be validating the change to Logstash publishing another way? If all docs are set to 9.0+, were these steps necessary?

[colleenmcginnis]

Then I noticed that all docs (including Beats) are set to 9.0+. Should I be validating the change to Logstash publishing another way? If all docs are set to 9.0+, were these steps necessary?

The dropdown always says 9.0+ for Stack versioned pages regardless of which branch it's being published from. To validate that it's working, you'll have to find a page that has different content in main and 9.0.

[colleenmcginnis]

@karenzone is there anything left to do here?

[karenzone]

@karenzone is there anything left to do here?

Just validate it. I've missed several opportunities because of my fast-follow backport habit.