Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Detection Engine] update API docs for new ES|QL rule #4052

Merged
merged 28 commits into from
Oct 26, 2023

Conversation

vitaliidm
Copy link
Contributor

@vitaliidm vitaliidm commented Oct 17, 2023

Contributes to #3817.

Previews:

@github-actions
Copy link

Documentation previews:

@mergify
Copy link
Contributor

mergify bot commented Oct 17, 2023

This pull request does not have a backport label. Could you fix it @vitaliidm? 🙏
To fixup this pull request, you need to add the backport labels for the needed
branches, such as:

  • v7.x is the label to automatically backport to the 7.x branch.
  • v7./d./d is the label to automatically backport to the 7./d branch. /d is the digit

NOTE: backport-skip has been added to this pull request.

Copy link
Contributor

@natasha-moore-elastic natasha-moore-elastic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for raising the PR, @vitaliidm ! Can we add request and response examples for creating an ESQL rule to the rules-api-create page? Just to keep the consistency, as the page contains examples for all other rule types.

docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
docs/detections/api/rules/rules-api-update.asciidoc Outdated Show resolved Hide resolved
@vitaliidm vitaliidm changed the title [Detection Engine] update API docs for new ES|QL rule [Draft][Detection Engine] update API docs for new ES|QL rule Oct 18, 2023
@vitaliidm vitaliidm changed the title [Draft][Detection Engine] update API docs for new ES|QL rule [Detection Engine] update API docs for new ES|QL rule Oct 18, 2023
Copy link
Contributor

@nastasha-solomon nastasha-solomon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for adding this content, @vitaliidm! I left some feedback and questions for your review. Let me know if I can elaborate on anything.

docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
docs/detections/api/rules/rules-api-update.asciidoc Outdated Show resolved Hide resolved
docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
docs/detections/api/rules/rules-api-update.asciidoc Outdated Show resolved Hide resolved
docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
@nastasha-solomon nastasha-solomon linked an issue Oct 18, 2023 that may be closed by this pull request
4 tasks
@nastasha-solomon nastasha-solomon self-assigned this Oct 18, 2023
Copy link
Contributor

@natasha-moore-elastic natasha-moore-elastic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, just a couple of suggestions to make spacing in the code examples consistent with other examples.

docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
Copy link
Contributor

@nastasha-solomon nastasha-solomon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just left one suggestion. Otherwise, LGTM! Thanks for putting this together, @vitaliidm!

docs/detections/api/rules/rules-api-create.asciidoc Outdated Show resolved Hide resolved
@vitaliidm vitaliidm merged commit 5f33c46 into elastic:main Oct 26, 2023
1 check passed
mergify bot pushed a commit that referenced this pull request Oct 26, 2023
* initial commit

* updates doc

* update API

* Update docs/detections/api/rules/rules-api-create.asciidoc

Co-authored-by: natasha-moore-elastic <[email protected]>

* Update docs/detections/api/rules/rules-api-create.asciidoc

Co-authored-by: natasha-moore-elastic <[email protected]>

* Update docs/detections/api/rules/rules-api-update.asciidoc

Co-authored-by: natasha-moore-elastic <[email protected]>

* CR feedback

* Update docs/detections/api/rules/rules-api-create.asciidoc

Co-authored-by: natasha-moore-elastic <[email protected]>

* Update docs/detections/api/rules/rules-api-create.asciidoc

Co-authored-by: natasha-moore-elastic <[email protected]>

* Update docs/detections/api/rules/rules-api-create.asciidoc

Co-authored-by: Nastasha Solomon <[email protected]>

* Update docs/detections/api/rules/rules-api-create.asciidoc

Co-authored-by: Nastasha Solomon <[email protected]>

* CR

* Update docs/detections/api/rules/rules-api-create.asciidoc

Co-authored-by: Nastasha Solomon <[email protected]>

* Update docs/detections/api/rules/rules-api-update.asciidoc

Co-authored-by: Nastasha Solomon <[email protected]>

* Combining tables and adding note to update rule

* Update docs/detections/api/rules/rules-api-create.asciidoc

* Removing extra term

* Combining tables in create rule

* Fixing tag rendering

* Adding ref to UI docs

* littile cleanup and fixes

* Update docs/detections/api/rules/rules-api-create.asciidoc

Co-authored-by: natasha-moore-elastic <[email protected]>

* Update docs/detections/api/rules/rules-api-create.asciidoc

Co-authored-by: natasha-moore-elastic <[email protected]>

* Update docs/detections/api/rules/rules-api-create.asciidoc

Co-authored-by: Nastasha Solomon <[email protected]>

---------

Co-authored-by: natasha-moore-elastic <[email protected]>
Co-authored-by: Nastasha Solomon <[email protected]>
Co-authored-by: nastasha.solomon <[email protected]>
(cherry picked from commit 5f33c46)
nastasha-solomon added a commit that referenced this pull request Oct 26, 2023
…#4052) (#4106)

Co-authored-by: natasha-moore-elastic <[email protected]>
Co-authored-by: Nastasha Solomon <[email protected]>
Co-authored-by: nastasha.solomon <[email protected]>
Co-authored-by: Vitalii Dmyterko <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Detection Engine][ESQL] - Document new rule type
3 participants