Add workbook instructions and validation guide

[v-sabiraj]

Add a comprehensive .github/instructions/workbook.instructions.md file that documents standards and validation guidance for Microsoft Sentinel/Azure Monitor workbooks. The new guide specifies required workbook JSON top-level fields (version, items, fallbackResourceIds, fromTemplateId, $schema), provides minimal and full JSON examples, item/parameter/query/chart guidelines, naming and folder conventions, metadata requirements (WorkbooksMetadata.json), versioning rules, common validation errors, and a PR description template to help contributors create and submit valid workbooks.

Required items, please complete

Change(s):

• See guidance below

Reason for Change(s):

• See guidance below

Version Updated:

• Required only for Detections/Analytic Rule templates
• See guidance below

Testing Completed:

• See guidance below

Checked that the validations are passing and have addressed any issues that are present:

• See guidance below

Guidance <- remove section before submitting

---

Before submitting this PR please ensure that you have read the following sections and filled out the changes, reason for change and testing complete sections:

Thank you for your contribution to the Microsoft Sentinel Github repo.

Details of the code changes in your submitted PR. Providing descriptions for pull requests ensures there is context to changes being made and greatly enhances the code review process. Providing associated Issues that this resolves also easily connects the reason.

Change(s):

• Updated syntax for XYZ.yaml

Reason for Change(s):

• New schema used for XYZ.yaml
• Resolves ISSUE Add Logstash required version to Readme file #1234

Version updated:

• Yes
• Detections/Analytic Rule templates are required to have the version updated

The code should have been tested in a Microsoft Sentinel environment that does not have any custom parsers, functions or tables, so that you validate no incorrect syntax and execution functions properly. If your submission requires a custom parser or function, it must be submitted with the PR.

Testing Completed:

• Yes/No/Need Help

Note: If updating a detection, you must update the version field.

Before the submission has been made, please look at running the KQL and Yaml Validation Checks locally.
https://github.com/Azure/Azure-Sentinel#run-kql-validation-locally

Checked that the validations are passing and have addressed any issues that are present:

• Yes/No/Need Help

Note: Let us know if you have tried fixing the validation error and need help.

References:

• Guidance for Detection checks
• General contribution guidance
• PR validation troubleshooting

---

[Copilot]

Pull request overview

Adds a new contributor instruction guide for Microsoft Sentinel/Azure Monitor workbook JSON files, aiming to standardize required fields, naming, metadata, validation expectations, and PR submission details.

Changes:

• Introduces .github/instructions/workbook.instructions.md with required workbook JSON field guidance and examples
• Documents workbook item/parameter/query/chart conventions and common validation errors
• Adds metadata (WorkbooksMetadata.json) requirements and a PR description template for workbook submissions

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 6 comments.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 7 comments.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

[rahul0216]

Mostly looks good. Please address the inline comments. Dismiss or implement comments provided by copilot with proper justification.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 8 comments.