Merge pull request elastic#8611 from elastic/jasper/backport/8301/5.x

[backport] PR elastic#8301 to 5.x - [docs] Init breaking changes

Former-commit-id: e5b1121

docs/breaking-changes.asciidoc

@@ -0,0 +1,12 @@
+[[breaking-changes]]
+== Breaking Changes
+
+This section discusses the changes that you need to be aware of when migrating
+your application from one version of Kibana to another.
+
+[[breaking-changes-5.0]]
+=== Breaking changes in 5.0
+* {k4pull}8013[Pull Request 8013]: Kibana binds to localhost by default
+* {k4pull}7855[Pull Request 7855]: Markdown headers require a space between the final hash and title
+* {k4pull}7308[Pull Request 7308]: Debian and rpm packages install assets to `/usr/share/kibana`, and configuration to `/etc/kibana`
+* {k4pull}6402[Pull Request 6402]: The plugin installer now has its own executable, it can be found at `/bin/kibana-plugin`

docs/index.asciidoc

@@ -16,6 +16,8 @@ include::setup.asciidoc[]
 
 include::getting-started.asciidoc[]
 
+include::breaking-changes.asciidoc[]
+
 include::plugins.asciidoc[]
 
 include::access.asciidoc[]