[FR] Update Security Docs Release Process to Add Index Rules Page Per Stack

[terrancedejesus]

Overview

Update security docs release process for detection rules to add all rules for each stack version, separate from downloadable updates.

As requested per @xcrzx.

Additional Information

More details to come.

Generate Prebuilt Rules Reference Page

Beta Give feedback

1. Review security-docs page 8.6+
2. Adjust devtools.py docs generation to generate rules index page
3. Update "How to Update Rules" References
4. Create a single PR to docs for testing and view preview link for testing

Manual Update PRs to Old Security-Docs Branches

Beta Give feedback

1. Update prebuilt rule docs for 8.9 security-docs#3640
   Feature: Prebuilt rules v8.9.0 +2
   
2. Update prebuilt rule docs for 8.8 security-docs#3646
   Feature: Prebuilt rules v8.8.0 +2
   
3. Update prebuilt rule docs for 8.7 security-docs#3650
   Feature: Prebuilt rules v8.7.0 +2
   

[Mikaayenson]

Update June 28

Based on our conversation yesterday between PM, TRaDE, security-docs team, and the docs team, we will still have to wait until Oct+ to migrate to docs.elastic.co. In the interim, we will address the docs request from AET by completing this stopgap issue.

We're planning to start working on this issue this week.

[approksiu]

Is it realistic to finish this work by July 5th (to accommodate BC schedule)? cc @Mikaayenson

[terrancedejesus]

Is it realistic to finish this work by July 5th (to accommodate BC schedule)? cc @Mikaayenson

It may not be anymore because we are doing an unexpected Detection Rules release today.

[approksiu]

Thanks @terrancedejesus. What is a realistic timeframe for this?

[terrancedejesus]

Thanks @terrancedejesus. What is a realistic timeframe for this?

By EOD July 7th, 2023 is doable.

[terrancedejesus]

@approksiu - This got de-prioritized by DED the last week. We are looking to pick this back up soon.

[approksiu]

@Mikaayenson please keep me posted about this, it still needs to be addressed. Thanks!

[Mikaayenson]

Update July 25th

The plan is to add a new method within our IntegrationSecurityDocs class to rebuild the prebuilt-rules-reference page. Once the PR is built, we can test using the release-docs workflow.

We will start this work today and hope to have this merged by the end of week.

[Mikaayenson]

For the prebuilt rule changes per release page, it instead needs to be removed from 8.8 and 8.7 (along with 8.9) since this doesn't exist.