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

[OAS][DOCS] Edit linting rule severity #190470

Merged
merged 2 commits into from
Aug 14, 2024
Merged

[OAS][DOCS] Edit linting rule severity #190470

merged 2 commits into from
Aug 14, 2024

Conversation

lcawl
Copy link
Contributor

@lcawl lcawl commented Aug 13, 2024

Summary

Relates to #189962 (comment), which was reverted due to the following linting errors:

643:20 error operation-operationId-valid-in-url operationId must not characters that are invalid when used in URL.
1182:11 error path-params Path parameter "id" must have "required" property that is set to "true". paths./api/alerting/rule/{id}.post.parameters[2]

The severity level of the operation-operationId-valid-in-url rule was changed to error in #189262 but per #189962 (comment) and later comments, the URL-encoded operationId values work when we publish the docs, so I've turned off this linting rule.

The path-params error is related to optional path parameters, which we discussed in #189962 (comment) and later comments. Since it validates several aspects of path parameters per https://docs.stoplight.io/docs/spectral/4dec24461f3af-open-api-rules#path-params, I've reduced its severity rather than turning it off. We can revisit that choice if it becomes too noisy.

@obltmachine
Copy link

🤖 GitHub comments

Expand to view the GitHub comments

Just comment with:

  • /oblt-deploy : Deploy a Kibana instance using the Observability test environments.
  • run docs-build : Re-trigger the docs validation. (use unformatted text in the comment!)

@lcawl lcawl added Team:Docs release_note:skip Skip the PR/issue when compiling release notes docs backport:prev-minor Backport to (9.0) the previous minor version (i.e. one version back from main) Feature:OAS Work or issues related to Core-provided mechanisms for generating OAS labels Aug 13, 2024
@lcawl lcawl marked this pull request as ready for review August 13, 2024 23:35
@lcawl lcawl requested a review from a team as a code owner August 13, 2024 23:35
@elasticmachine
Copy link
Contributor

Pinging @elastic/kibana-docs (Team:Docs)

@lcawl lcawl changed the title [OAS] Edit linting rule severity [OAS][DOCS] Edit linting rule severity Aug 13, 2024
Copy link
Contributor

@kilfoyle kilfoyle left a comment

Choose a reason for hiding this comment

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

LGTM! 🐭

@lcawl lcawl enabled auto-merge (squash) August 14, 2024 13:54
@kibana-ci
Copy link
Collaborator

💛 Build succeeded, but was flaky

Failed CI Steps

Metrics [docs]

✅ unchanged

History

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

@lcawl lcawl merged commit 286e0e0 into elastic:main Aug 14, 2024
20 checks passed
@kibanamachine
Copy link
Contributor

💔 All backports failed

Status Branch Result
8.15 Backport failed because of merge conflicts

Manual backport

To create the backport manually run:

node scripts/backport --pr 190470

Questions ?

Please refer to the Backport tool documentation

lcawl added a commit to lcawl/kibana that referenced this pull request Aug 14, 2024
@lcawl
Copy link
Contributor Author

lcawl commented Aug 14, 2024

💚 All backports created successfully

Status Branch Result
8.15

Note: Successful backport PRs will be merged automatically after passing CI.

Questions ?

Please refer to the Backport tool documentation

@lcawl lcawl deleted the lint-oas branch August 14, 2024 16:29
lcawl added a commit that referenced this pull request Aug 15, 2024
# Backport

This will backport the following commits from `main` to `8.15`:
- [[OAS][DOCS] Edit linting rule severity
(#190470)](#190470)

<!--- Backport version: 8.9.8 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Lisa
Cawley","email":"[email protected]"},"sourceCommit":{"committedDate":"2024-08-14T15:15:29Z","message":"[OAS][DOCS]
Edit linting rule severity
(#190470)","sha":"286e0e0a9fffcb9b90d339551e67cdb1c5c60183","branchLabelMapping":{"^v8.16.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","docs","backport:prev-minor","Feature:OAS","v8.16.0"],"number":190470,"url":"https://github.com/elastic/kibana/pull/190470","mergeCommit":{"message":"[OAS][DOCS]
Edit linting rule severity
(#190470)","sha":"286e0e0a9fffcb9b90d339551e67cdb1c5c60183"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v8.16.0","labelRegex":"^v8.16.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/190470","number":190470,"mergeCommit":{"message":"[OAS][DOCS]
Edit linting rule severity
(#190470)","sha":"286e0e0a9fffcb9b90d339551e67cdb1c5c60183"}}]}]
BACKPORT-->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport:prev-minor Backport to (9.0) the previous minor version (i.e. one version back from main) docs Feature:OAS Work or issues related to Core-provided mechanisms for generating OAS release_note:skip Skip the PR/issue when compiling release notes Team:Docs v8.15.1 v8.16.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants