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

[Enterprise Search] Add ml doc links #141921

Merged
merged 6 commits into from
Oct 4, 2022
Merged

Conversation

efegurkan
Copy link
Member

Summary

Adds missing doc links for the Inference card and modal

Checklist

  • Documentation was added for features that require explanation or tutorials

@efegurkan efegurkan added Feature:Plugins release_note:skip Skip the PR/issue when compiling release notes documentation auto-backport Deprecated - use backport:version if exact versions are needed v8.5.0 v8.6.0 labels Sep 27, 2022
@efegurkan efegurkan requested a review from a team as a code owner September 27, 2022 11:12
@efegurkan efegurkan requested a review from a team September 27, 2022 11:12
Copy link
Contributor

@chriscressman chriscressman left a comment

Choose a reason for hiding this comment

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

I suggested a potential refactoring, but I'm approving because the links look good.

@@ -129,6 +129,7 @@ export const getDocLinks = ({ kibanaBranch }: GetDocLinkOptions): DocLinks => {
crawlerGettingStarted: `${ENTERPRISE_SEARCH_DOCS}crawler-getting-started.html`,
crawlerManaging: `${ENTERPRISE_SEARCH_DOCS}crawler-managing.html`,
crawlerOverview: `${ENTERPRISE_SEARCH_DOCS}crawler.html`,
deployTrainedModels: `${ELASTIC_WEBSITE_URL}guide/en/machine-learning/${DOC_LINK_VERSION}/ml-nlp-deploy-models.html`,
Copy link
Contributor

Choose a reason for hiding this comment

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

Should we create MACHINE_LEARNING_DOCS, which encapsulates ${ELASTIC_WEBSITE_URL}guide/en/machine-learning/${DOC_LINK_VERSION} ?

I ask because this entry stands out as different from the others.

Copy link
Contributor

@lcawl lcawl Sep 27, 2022

Choose a reason for hiding this comment

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

There's an existing link (startTrainedModelsDeployment) that takes you to https://www.elastic.co/guide/en/machine-learning/master/ml-nlp-deploy-models.html#ml-nlp-deploy-model. Is this new one added since you want to be taken to the top of the page?

Copy link
Member Author

Choose a reason for hiding this comment

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

Makes sense to me. There is a whole bunch of other links on the same file from L402 to L429.
To make sure I test it throughly, I will create the ${MACHINE_LEARNING_DOCS} but merge them in a different PR (following up this one) that aims for 8.6 instead of 8.5

Copy link
Member Author

Choose a reason for hiding this comment

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

@lcawl startTrainedModelsDeployment is pointing to an anchor on the page. I wanted to link to the full page instead.

Copy link
Contributor

Choose a reason for hiding this comment

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

@chriscressman Yes, it's true that we could add a new shortcut for the ML Guide, but it's not necessary in this PR IMO. Each time a new shortcut like that is created, we also have to update the doc build to be aware of it, so it would require a matching PR in the docs repo.

Copy link
Contributor

Choose a reason for hiding this comment

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

@chriscressman Good idea to add the shortcut for ML! I took note of it and will add the shortcut soon and handle the docs repo PR, too, if it's okay with you.

Copy link
Contributor

Choose a reason for hiding this comment

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

All sounds good to me! I agree we don't need the change on this PR and can handle it separately if others think that's useful.

Copy link
Contributor

Choose a reason for hiding this comment

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

I added the shortcut via #142091 and elastic/docs#2534. Thanks for your patience!

@efegurkan efegurkan enabled auto-merge (squash) September 28, 2022 07:56
@efegurkan
Copy link
Member Author

@elastic/kibana-docs that would be great if I can get an approval for this one.

@efegurkan
Copy link
Member Author

@elasticmachine merge upstream

@kibanamachine kibanamachine requested a review from a team September 29, 2022 11:03
@efegurkan
Copy link
Member Author

@elasticmachine merge upstream

@efegurkan
Copy link
Member Author

@elasticmachine merge upstream

@efegurkan
Copy link
Member Author

@elastic/kibana-docs hello, it's me again, we would need this link for the next BC so if someone can review it before that would be great.

@elastic/ent-search-docs-team Also while we added this handle, we need a reapproval from you I guess @chriscressman

@efegurkan
Copy link
Member Author

@elasticmachine merge upstream

@kibana-ci
Copy link
Collaborator

💚 Build Succeeded

Metrics [docs]

Async chunks

Total size of all lazy-loaded chunks that will be downloaded as the user navigates the app

id before after diff
enterpriseSearch 1.7MB 1.7MB -16.0B

Page load bundle

Size of the bundles that are downloaded on every page load. Target size is below 100kb

id before after diff
core 366.8KB 366.9KB +61.0B
enterpriseSearch 27.9KB 28.0KB +137.0B
total +198.0B

History

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

@efegurkan efegurkan merged commit b66d12a into elastic:main Oct 4, 2022
kibanamachine pushed a commit that referenced this pull request Oct 4, 2022
* Add documentation links for ml inference card and modal

* Fix link

(cherry picked from commit b66d12a)
@kibanamachine
Copy link
Contributor

💚 All backports created successfully

Status Branch Result
8.5

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

Questions ?

Please refer to the Backport tool documentation and see the Github Action logs for details

kibanamachine added a commit that referenced this pull request Oct 4, 2022
* [Enterprise Search] Add ml doc links (#141921)

* Add documentation links for ml inference card and modal

* Fix link

(cherry picked from commit b66d12a)

* Fix link type for 8.5

Co-authored-by: Efe Gürkan YALAMAN <[email protected]>
WafaaNasr pushed a commit to WafaaNasr/kibana that referenced this pull request Oct 11, 2022
* Add documentation links for ml inference card and modal

* Fix link
WafaaNasr pushed a commit to WafaaNasr/kibana that referenced this pull request Oct 14, 2022
* Add documentation links for ml inference card and modal

* Fix link
@efegurkan efegurkan deleted the add-ml-doc-links branch October 14, 2022 15:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
auto-backport Deprecated - use backport:version if exact versions are needed documentation Feature:Plugins release_note:skip Skip the PR/issue when compiling release notes v8.5.0 v8.6.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants