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

Enhance plugin documentation #146678

Merged

Conversation

gsoldevila
Copy link
Contributor

@gsoldevila gsoldevila commented Nov 30, 2022

The PR tackles a couple of improvements for the new 'notifications' plugin documentation:

  • Add a link to the plugin API description in the kibana-dev-docs nav bar.
  • Convert the README to mdx.

@gsoldevila gsoldevila added Team:Core Core services & architecture: plugins, logging, config, saved objects, http, ES client, i18n, etc Team:AppServicesSv release_note:skip Skip the PR/issue when compiling release notes docs DevDocs documentation APIDocs backport:prev-minor Backport to (8.x) the previous minor version (i.e. one version back from main) v8.6.0 v8.7.0 labels Nov 30, 2022
@gsoldevila gsoldevila requested a review from a team as a code owner November 30, 2022 11:50
@elasticmachine
Copy link
Contributor

Pinging @elastic/kibana-core (Team:Core)

@elasticmachine
Copy link
Contributor

Pinging @elastic/kibana-app-services (Team:AppServicesSv)

@github-actions
Copy link
Contributor

Documentation preview:

Copy link
Contributor

@TinaHeiligers TinaHeiligers left a comment

Choose a reason for hiding this comment

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

We're almost there!
I think we're missing some frontmatter for the internal dev docs about the notifications plugin but I'm checking with the docs team to see if that's still needed.
@elastic/kibana-docs are the instructions for internal plugin documentation still relevant?

@TinaHeiligers
Copy link
Contributor

We also need to let end-users know about the yml configuration needed to enable notifications via email. Maybe a section somewhere in https://www.elastic.co/guide/en/kibana/current/settings.html will be ok. For more detailed setup, we could add a new section.

Copy link
Contributor

@rshen91 rshen91 left a comment

Choose a reason for hiding this comment

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

LGTM

@gsoldevila gsoldevila force-pushed the kbn-140743-notifications-api-update-doc branch from 6923993 to 9d73483 Compare October 16, 2023 09:13
@TinaHeiligers
Copy link
Contributor

With recent changes, frontmatter isn't needed anymore. After rebasing and updating to work with our docs setup now, we should be good to get this in.

@TinaHeiligers TinaHeiligers self-requested a review November 28, 2023 16:18
Copy link
Contributor

@TinaHeiligers TinaHeiligers left a comment

Choose a reason for hiding this comment

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

LGTM on docs building.

@kibana-ci
Copy link
Collaborator

💚 Build Succeeded

Metrics [docs]

✅ unchanged

History

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

cc @gsoldevila

@gsoldevila gsoldevila merged commit 98b2cfb into elastic:main Nov 28, 2023
31 checks passed
kibanamachine pushed a commit to kibanamachine/kibana that referenced this pull request Nov 28, 2023
The PR tackles a couple of improvements for the new `'notifications'`
plugin documentation:

- Add a link to the plugin API description in the kibana-dev-docs nav
bar.
- Convert the README to `mdx`.

---------

Co-authored-by: kibanamachine <[email protected]>
(cherry picked from commit 98b2cfb)
@kibanamachine
Copy link
Contributor

💚 All backports created successfully

Status Branch Result
8.11

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

Questions ?

Please refer to the Backport tool documentation

kibanamachine added a commit that referenced this pull request Nov 28, 2023
# Backport

This will backport the following commits from `main` to `8.11`:
- [Enhance plugin documentation
(#146678)](#146678)

<!--- Backport version: 8.9.7 -->

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

<!--BACKPORT [{"author":{"name":"Gerard
Soldevila","email":"[email protected]"},"sourceCommit":{"committedDate":"2023-11-28T19:58:46Z","message":"Enhance
plugin documentation (#146678)\n\nThe PR tackles a couple of
improvements for the new `'notifications'`\nplugin documentation:\n\n-
Add a link to the plugin API description in the kibana-dev-docs
nav\nbar.\n- Convert the README to
`mdx`.\n\n---------\n\nCo-authored-by: kibanamachine
<[email protected]>","sha":"98b2cfbbb0442898e84189291b7f5c5a725a6115","branchLabelMapping":{"^v8.12.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Core","Team:AppServicesSv","release_note:skip","docs","DevDocs","documentation","APIDocs","backport:prev-minor","v8.12.0"],"number":146678,"url":"https://github.com/elastic/kibana/pull/146678","mergeCommit":{"message":"Enhance
plugin documentation (#146678)\n\nThe PR tackles a couple of
improvements for the new `'notifications'`\nplugin documentation:\n\n-
Add a link to the plugin API description in the kibana-dev-docs
nav\nbar.\n- Convert the README to
`mdx`.\n\n---------\n\nCo-authored-by: kibanamachine
<[email protected]>","sha":"98b2cfbbb0442898e84189291b7f5c5a725a6115"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v8.12.0","labelRegex":"^v8.12.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/146678","number":146678,"mergeCommit":{"message":"Enhance
plugin documentation (#146678)\n\nThe PR tackles a couple of
improvements for the new `'notifications'`\nplugin documentation:\n\n-
Add a link to the plugin API description in the kibana-dev-docs
nav\nbar.\n- Convert the README to
`mdx`.\n\n---------\n\nCo-authored-by: kibanamachine
<[email protected]>","sha":"98b2cfbbb0442898e84189291b7f5c5a725a6115"}}]}]
BACKPORT-->

Co-authored-by: Gerard Soldevila <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
APIDocs backport:prev-minor Backport to (8.x) the previous minor version (i.e. one version back from main) DevDocs docs documentation release_note:skip Skip the PR/issue when compiling release notes Team:Core Core services & architecture: plugins, logging, config, saved objects, http, ES client, i18n, etc v8.11.2 v8.12.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants