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

[6.8] [DOCS] Adds kibana-pull attribute for release docs (#69554) #69579

Merged
merged 3 commits into from
Jun 23, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4,760 changes: 2,380 additions & 2,380 deletions docs/CHANGELOG.asciidoc

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -85,5 +85,5 @@ node ../../kibana/scripts/functional_test_runner
[float]
==== Using esArchiver

We're working on documentation for this, but for now the best place to look is the original {pull}10359[pull request].
We're working on documentation for this, but for now the best place to look is the original {kibana-pull}10359[pull request].

12 changes: 12 additions & 0 deletions docs/developer/plugin/development-plugin-localization.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,11 @@ export const HELLO_WORLD = i18n.translate('hello.wonderful.world', {
});
-----------

<<<<<<< HEAD
Full details are {repo}tree/6.7/packages/kbn-i18n#vanilla-js[here].
=======
Full details are {kib-repo}tree/master/packages/kbn-i18n#vanilla-js[here].
>>>>>>> d26cbef389... [DOCS] Adds kibana-pull attribute for release docs (#69554)

[float]
===== i18n for React
Expand All @@ -131,7 +135,11 @@ export const Component = () => {
};
-----------

<<<<<<< HEAD
Full details are {repo}tree/6.7/packages/kbn-i18n#react[here].
=======
Full details are {kib-repo}tree/master/packages/kbn-i18n#react[here].
>>>>>>> d26cbef389... [DOCS] Adds kibana-pull attribute for release docs (#69554)



Expand All @@ -152,7 +160,11 @@ The translation directive has the following syntax:
></ANY>
-----------

<<<<<<< HEAD
Full details are {repo}tree/6.7/packages/kbn-i18n#angularjs[here].
=======
Full details are {kib-repo}tree/master/packages/kbn-i18n#angularjs[here].
>>>>>>> d26cbef389... [DOCS] Adds kibana-pull attribute for release docs (#69554)


[float]
Expand Down
23 changes: 23 additions & 0 deletions docs/developer/plugin/development-plugin-resources.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,18 +9,26 @@ Many Kibana developers hang out on `irc.freenode.net` in the `#kibana` channel.

[float]
==== Some light reading
<<<<<<< HEAD
- Our {repo}blob/master/CONTRIBUTING.md[contributing guide] can help you get a development environment going
- Tim Roes' excellent blog series https://www.timroes.de/2016/02/21/writing-kibana-plugins-custom-applications/[Writing Kibana Plugins]

[float]
==== Videos
- https://www.elastic.co/elasticon/2015/sf/contributors-guide-to-the-kibana-galaxy[Contributors Guide to the Kibana Galaxy]
- https://www.elastic.co/elasticon/conf/2016/sf/how-to-build-your-own-kibana-plugins[Kibana Plugin Dev - Elasticon 2016]
=======
Our {kib-repo}blob/master/CONTRIBUTING.md[contributing guide] can help you get a development environment going.
>>>>>>> d26cbef389... [DOCS] Adds kibana-pull attribute for release docs (#69554)

[float]
==== Plugin Generator

<<<<<<< HEAD
It is recommended that you kick-start your plugin by generating it with the {repo}tree/{branch}/packages/kbn-plugin-generator[Kibana Plugin Generator]. Run the following within the Kibana repo and you will be asked a couple questions, see some progress bars, and have a freshly generated plugin ready for you to play within Kibana's sibling `kibana-extra` folder.
=======
We recommend that you kick-start your plugin by generating it with the {kib-repo}tree/{branch}/packages/kbn-plugin-generator[Kibana Plugin Generator]. Run the following in the Kibana repo, and you will be asked a couple questions, see some progress bars, and have a freshly generated plugin ready for you to play with in Kibana's `plugins` folder.
>>>>>>> d26cbef389... [DOCS] Adds kibana-pull attribute for release docs (#69554)

["source","shell"]
-----------
Expand All @@ -43,7 +51,11 @@ The Kibana directory must be named `kibana`, and your plugin directory must be l

[float]
==== References in the code
<<<<<<< HEAD
- {repo}blob/{branch}/src/server/plugins/lib/plugin.js[Plugin class]: What options does the `kibana.Plugin` class accept?
=======
- {kib-repo}blob/{branch}/src/legacy/server/plugins/lib/plugin.js[Plugin class]: What options does the `kibana.Plugin` class accept?
>>>>>>> d26cbef389... [DOCS] Adds kibana-pull attribute for release docs (#69554)
- <<development-uiexports>>: What type of exports are available?

[float]
Expand Down Expand Up @@ -71,4 +83,15 @@ Plugin code can be written in http://www.typescriptlang.org/[TypeScript] if desi
}
-----------

<<<<<<< HEAD
TypeScript code is automatically converted into JavaScript during development, but not in the distributable version of Kibana. If you use the {repo}blob/{branch}/packages/kbn-plugin-helpers[@kbn/plugin-helpers] to build your plugin then your `.ts` and `.tsx` files will be permanently transpiled before your plugin is archived. If you have your own build process, make sure to run the TypeScript compiler on your source files and ship the compilation output so that your plugin will work with the distributable version of Kibana.
=======
TypeScript code is automatically converted into JavaScript during development,
but not in the distributable version of Kibana. If you use the
{kib-repo}blob/{branch}/packages/kbn-plugin-helpers[@kbn/plugin-helpers] to build your plugin, then your `.ts` and `.tsx` files will be permanently transpiled before your plugin is archived. If you have your own build process, make sure to run the TypeScript compiler on your source files and ship the compilation output so that your plugin will work with the distributable version of Kibana.

==== {kib} platform migration guide

{kib-repo}blob/{branch}/src/core/MIGRATION.md#migrating-legacy-plugins-to-the-new-platform[This guide]
provides an action plan for moving a legacy plugin to the new platform.
>>>>>>> d26cbef389... [DOCS] Adds kibana-pull attribute for release docs (#69554)
10 changes: 9 additions & 1 deletion docs/developer/visualize/development-visualize-index.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,12 @@ However, these docs will be kept up-to-date to reflect the current implementatio

include::development-embedding-visualizations.asciidoc[]

include::development-create-visualization.asciidoc[]
<<<<<<< HEAD
include::development-create-visualization.asciidoc[]
=======
* The <<breaking-changes,breaking changes>> documentation, where we try to capture any changes to the APIs as they occur across minors.
* link:https://github.com/elastic/kibana/issues/44121[Meta issue] which is tracking the move of the plugin to the new Kibana platform
* Our link:https://www.elastic.co/blog/join-our-elastic-stack-workspace-on-slack[Elastic Stack workspace on Slack].
* The {kib-repo}blob/{branch}/src/plugins/visualizations[source code], which will continue to be
the most accurate source of information.
>>>>>>> d26cbef389... [DOCS] Adds kibana-pull attribute for release docs (#69554)
8 changes: 2 additions & 6 deletions docs/gs-index.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,10 @@ release-state can be: released | prerelease | unreleased

:docker-image: docker.elastic.co/kibana/kibana:{version}
:es-ref: https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/
:kibana-ref: https://www.elastic.co/guide/en/kibana/{branch}
:xpack-ref: https://www.elastic.co/guide/en/x-pack/current/
:repo: https://github.com/elastic/kibana/
:issue: {repo}issues/
:pull: {repo}pull/
:commit: {repo}commit/
:security: https://www.elastic.co/community/security/

include::{docs-root}/shared/attributes.asciidoc[]

include::introduction.asciidoc[]

include::setup/install.asciidoc[]
Expand Down
6 changes: 1 addition & 5 deletions docs/index.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,7 @@ include::{asciidoc-dir}/../../shared/versions/stack/{source_branch}.asciidoc[]

:docker-repo: docker.elastic.co/kibana/kibana
:docker-image: docker.elastic.co/kibana/kibana:{version}
:repo: https://github.com/elastic/kibana/
:issue: {repo}issues/
:pull: {repo}pull/
:commit: {repo}commit/
:blob: {repo}blob/{branch}/
:blob: {kib-repo}blob/{branch}/
:security-ref: https://www.elastic.co/community/security/

include::{asciidoc-dir}/../../shared/attributes.asciidoc[]
Expand Down
2 changes: 1 addition & 1 deletion docs/migration/migrate_6_0.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ See also <<release-highlights>> and <<release-notes>>.

[float]
=== Saved objects `bulk_get` and `find` endpoints renamed
//{pull}17512[#17512]
//{kib-pull}17512[#17512]

*Details:*
To support sending larger and more expressive queries to the Saved Objects find
Expand Down
2 changes: 1 addition & 1 deletion docs/plugins/known-plugins.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -68,4 +68,4 @@ Use it to create, edit and embed visualizations, and also to search inside an em
* https://github.com/datasweet-fr/kibana-datasweet-formula[Datasweet Formula] (datasweet) - enables calculated metric on any standard Kibana visualization.
* https://github.com/pjhampton/kibana-prometheus-exporter[Prometheus Exporter] - exports the Kibana metrics in the prometheus format

NOTE: If you want your plugin to be added to this page, open a {repo}tree/{branch}/docs/plugins/known-plugins.asciidoc[pull request].
NOTE: If you want your plugin to be added to this page, open a {kib-repo}tree/{branch}/docs/plugins/known-plugins.asciidoc[pull request].
4 changes: 2 additions & 2 deletions x-pack/dev-tools/xkb_release_notes.pl
Original file line number Diff line number Diff line change
Expand Up @@ -111,7 +111,7 @@ sub dump_issues {
}
my $number = $issue->{number};

# print encode_utf8("* $title {pull}${number}[#${number}]");
# print encode_utf8("* $title {kibana-pull}${number}[#${number}]");
print encode_utf8("* $title");
print "\n";
print encode_utf8("// https://github.com/${User_Repo}pull/${number}[#${number}]");
Expand All @@ -120,7 +120,7 @@ sub dump_issues {
print keys %uniq > 1
? " (issues: "
: " (issue: ";
# print join ", ", map {"{issue}${_}[#${_}]"}
# print join ", ", map {"{kib-issue}${_}[#${_}]"}
# print join ", ", map {"#${_}"}
print join ", ", map {"https://github.com/${User_Repo}issues/${_}[#${_}]"}
sort keys %uniq;
Expand Down