Skip to content

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

Merged
lcawl merged 2 commits intoelastic:mainfrom
lcawl:lint-oas
Aug 14, 2024
Merged

[OAS][DOCS] Edit linting rule severity#190470
lcawl merged 2 commits intoelastic:mainfrom
lcawl:lint-oas

Conversation

@lcawl
Copy link
Copy Markdown
Member

@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
Copy Markdown

🤖 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 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
Copy Markdown
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
Copy Markdown
Member

@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
Copy Markdown

💛 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
@kibanamachine
Copy link
Copy Markdown
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
Copy Markdown
Member 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":"lcawley@elastic.co"},"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

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