[DOCS] Relocate "Plugins" page#54974
[DOCS] Relocate "Plugins" page#54974jrodewig merged 4 commits intoelastic:masterfrom jrodewig:docs__relocate-plugins-module
Conversation
|
Pinging @elastic/es-core-infra (:Core/Infra/Plugins) |
|
Pinging @elastic/es-docs (>docs) |
rjernst
left a comment
There was a problem hiding this comment.
This looks fine. I have two questions:
- why is this only targeted for 8.0?
- Most of the content in the linked plugins documentation is related to how to install plugins and which are available, but there is also some there that is for plugin authors on developing plugins, which doesn't seem like linking from setup gives the best visibility. Why are plugins in their own section (book?) and would splitting that book up into managing plugins vs developing plugins better serve users? This is more a question for the long term future and only semi related to this particular change.
|
Hey @rjernst! Thanks for raising these questions.
This PR is part of a larger effort to move content out of the Modules section. While this particular change doesn't involve any redirects/removed pages, many related to that effort will. Going forward, we're trying to treat redirects/removed pages as "breaking changes" and only include them in major releases. My original thought was to try to group all modules-related content relocations under the 8.0 release, but I don't have an issue backporting this particular PR if wanted.
I don't have much info about the history of that decision. @debadair might be able to help us out though?
That would be outside the scope of this PR, but I agree. The link here would primarily benefit end users rather than plugin authors. Since the bulk of the plugin guide's content is aimed at end users, I think this link/location is okay. I created #54982 to address splitting off a plugins developer guide and plan to discuss it in our next ES docs meeting. Please feel free to comment on that issue or attend the meeting. I'd love to hear any other thoughts you have. |
debadair
left a comment
There was a problem hiding this comment.
I agree that the information for plugin developers is a bit buried, and organizing content around the intended audience is generally a helpful pattern. I think we should hold off on trying to move it until we sort the doc nav changes, though. For now, it might be worth updating the description to explicitly link to the information about building your own plugins.
Moves the Plugins page under Set up Elasticsearch from the Modules section.
Closes #53310