Prep next branch for Kuma release 1.4.0 (#587)

* Improve log and trace docs for grafana (#501)

Merging after approval to work with an updated master for next branch cleanup and more.

The docs were not very clear (some trace config was explained in the log docs).
This cleans this a little.

Signed-off-by: Charly Molter <charly.molter@konghq.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* chore(deps): bump path-parse from 1.0.6 to 1.0.7 (#503)

Bumps [path-parse](https://github.com/jbgutierrez/path-parse) from 1.0.6 to 1.0.7.
- [Release notes](https://github.com/jbgutierrez/path-parse/releases)
- [Commits](https://github.com/jbgutierrez/path-parse/commits/v1.0.7)

---
updated-dependencies:
- dependency-name: path-parse
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* chore(deps): bump url-parse from 1.5.1 to 1.5.3 (#509)

Bumps [url-parse](https://github.com/unshiftio/url-parse) from 1.5.1 to 1.5.3.
- [Release notes](https://github.com/unshiftio/url-parse/releases)
- [Commits](unshiftio/url-parse@1.5.1...1.5.3)

---
updated-dependencies:
- dependency-name: url-parse
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* feat(*) add websockets to supported protocols (#507)

Signed-off-by: Bart Smykla <bartek@smykla.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* docs(http-api) new fields in dataplane and mesh insights (#505)

Signed-off-by: Jakub Dyszkiewicz <jakub.dyszkiewicz@gmail.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* docs(policies) intermediate CA (#506)

Signed-off-by: Jakub Dyszkiewicz <jakub.dyszkiewicz@gmail.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* docs(policies) external service SNI (#494)

Signed-off-by: Jakub Dyszkiewicz <jakub.dyszkiewicz@gmail.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* Updated mtls certificate requirement for provided CA (#511)

* chore(deps): bump path-parse from 1.0.6 to 1.0.7 (#503)

Bumps [path-parse](https://github.com/jbgutierrez/path-parse) from 1.0.6 to 1.0.7.
- [Release notes](https://github.com/jbgutierrez/path-parse/releases)
- [Commits](https://github.com/jbgutierrez/path-parse/commits/v1.0.7)

---
updated-dependencies:
- dependency-name: path-parse
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore(deps): bump url-parse from 1.5.1 to 1.5.3 (#509)

Bumps [url-parse](https://github.com/unshiftio/url-parse) from 1.5.1 to 1.5.3.
- [Release notes](https://github.com/unshiftio/url-parse/releases)
- [Commits](unshiftio/url-parse@1.5.1...1.5.3)

---
updated-dependencies:
- dependency-name: url-parse
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* feat(*) add websockets to supported protocols (#507)

Signed-off-by: Bart Smykla <bartek@smykla.com>

* Updated mtls certificate requirement for provided CA

Signed-off-by: nikita15p <nikita15p@gmail.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Bart Smykla <bartek@smykla.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* docs(http-api) adjust insight fields (#512)

Signed-off-by: Jakub Dyszkiewicz <jakub.dyszkiewicz@gmail.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* Add documentation for virtual-outbound (#508)

* Add documentation for virtual-outbound

Signed-off-by: Charly Molter <charly.molter@konghq.com>

* Apply suggestions from code review

Co-authored-by: Jennifer Rondeau <Bradamant3@users.noreply.github.com>
Signed-off-by: Charly Molter <charly.molter@konghq.com>

* Update with review comments

Signed-off-by: Charly Molter <charly.molter@konghq.com>

* Fix bad indent in policies

Signed-off-by: Charly Molter <charly.molter@konghq.com>

* Add to sidebar

Signed-off-by: Charly Molter <charly.molter@konghq.com>

Co-authored-by: Jennifer Rondeau <Bradamant3@users.noreply.github.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* docs(kuma-cp) permissive mTLS mode (#510)

* docs(kuma-cp) permissive mTLS mode

Signed-off-by: Ilya Lobkov <ilya.lobkov@konghq.com>

* Update docs/docs/1.2.3/policies/mutual-tls.md

Co-authored-by: Jennifer Rondeau <Bradamant3@users.noreply.github.com>

* docs(kuma-cp) warning

Signed-off-by: Ilya Lobkov <ilya.lobkov@konghq.com>

Co-authored-by: Jennifer Rondeau <Bradamant3@users.noreply.github.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* doc(kuma-cp) Add notes on external service rate limits (#514)

Signed-off-by: Paul Parkanzky <paul.parkanzky@konghq.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* initial prep for 1.3.0 release

Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* docs(http-api) adjust zones+insights fields (#515)

Signed-off-by: Tomasz Wylężek <tomwylezek@gmail.com>
Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* add current 1.2.3 directory and files

Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* fix up munged side nav

Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* blog: 1.3.0 (#520)

* blog: 1.3.0

* release: updating home page news banner for 1.3.0

* add working directory for next branch

Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* docs(security) service account token considerations (#528)

Signed-off-by: Jakub Dyszkiewicz <jakub.dyszkiewicz@gmail.com>

* docs(kuma-cp) add tabs for Fault Injection policy (#535)

Signed-off-by: Ilya Lobkov <ilya.lobkov@konghq.com>

* 1.3.1 release

Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* docs(*) new section "External Services and Locality Aware Load Balancing" (#552)

* docs(kuma-cp) es and locality-aware lb

Signed-off-by: Ilya Lobkov <ilya.lobkov@konghq.com>

* docs(kuma-cp) create 4.4.4 from 1.3.1

Signed-off-by: Ilya Lobkov <ilya.lobkov@konghq.com>

* add rest of working directory for next release so we can build from this branch

Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* docs(policy) retriable methods configuration (#567)

* docs(policy) retriable methods configuration

Signed-off-by: Liupeng <webliupeng@gmail.com>

* docs(policy) improve retriableMethods document syntax

Co-authored-by: Mike Beaumont <mjboamail@gmail.com>
Signed-off-by: Liupeng <webliupeng@gmail.com>

Co-authored-by: Mike Beaumont <mjboamail@gmail.com>

* update with changes to master branch

Signed-off-by: Jennifer Rondeau <jennifer.rondeau@konghq.com>

* docs(*) update api reference for aggregate stats (#570)

* docs(*) update api reference for aggregate stats

As MeshInsights will contain `dataplanesByTypes` field which will
contain aggregated by type statistics for dataplanes

Also updated supported version of Kubernetes as we are now
supporting k8s 1.17+

Signed-off-by: Bart Smykla <bartek@smykla.com>

* docs(*) modify api referece for mesh insight

1. Provided JSON was wrong (mtls section was one level to high)
2. Added section for aggregated informations about services

Signed-off-by: Bart Smykla <bartek@smykla.com>

* docs(api) add Global Insights endpoint to api ref (#572)

Signed-off-by: Bart Smykla <bartek@smykla.com>

* Update the kumactl certificate generation syntax. (#578)

* Update the kumactl certificate generation syntax.

This fixes #574.

Signed-off-by: James Peach <james.peach@konghq.com>

* Fix spelling.

Signed-off-by: James Peach <james.peach@konghq.com>

* Add `serviceVipEnabled` configuration (#584)

Reword documentation to let people select virtual-outbound as favoured option

Signed-off-by: Charly Molter <charly.molter@konghq.com>

* Add documentation for the ignore annotation (#583)

* Add documentation for the ignore annotation

Signed-off-by: Charly Molter <charly.molter@konghq.com>

* Fix typo

Signed-off-by: Charly Molter <charly.molter@konghq.com>

* docs(security) access control (#585)

Signed-off-by: Jakub Dyszkiewicz <jakub.dyszkiewicz@gmail.com>

* prep for 1.4.0 release

* docs(api) add resources to GlobalInsights + more (#580)

Structure of GlobalInsights changed to allow return more of global
resources

Signed-off-by: Bart Smykla <bartek@smykla.com>

* api server authentication (#554)

Signed-off-by: Jakub Dyszkiewicz <jakub.dyszkiewicz@gmail.com>

Co-authored-by: Jennifer Rondeau <Bradamant3@users.noreply.github.com>

* draft changes for community call UI

* update after merge

* add icon (#588)

Signed-off-by: Tomasz Wylężek <tomwylezek@gmail.com>

* docs(security) change kong-mesh-system to kuma-system (#589)

Signed-off-by: Mike Beaumont <mjboamail@gmail.com>

* finish draft blog post, edit home page, fix up community call form

* Blog post (#592)

* blog: 1.4.0

* blog: 1.4.0

Co-authored-by: Marco <marco@Marcos-MacBook-Pro.local>
Co-authored-by: subnetmarco <88.marco@gmail.com>

Co-authored-by: Charly Molter <charly.molter@konghq.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Bart Smykla <bartek@smykla.com>
Co-authored-by: Jakub Dyszkiewicz <jakub.dyszkiewicz@gmail.com>
Co-authored-by: Nikita Pande <37657012+nikita15p@users.noreply.github.com>
Co-authored-by: Ilya Lobkov <ilya.lobkov@konghq.com>
Co-authored-by: parkanzky <42279121+parkanzky@users.noreply.github.com>
Co-authored-by: Tomasz Wylężek <tomwylezek@gmail.com>
Co-authored-by: Marco Palladino <88.marco@gmail.com>
Co-authored-by: webliupeng <webliupeng@gmail.com>
Co-authored-by: Mike Beaumont <mjboamail@gmail.com>
Co-authored-by: James Peach <james.peach@konghq.com>
Co-authored-by: Marco <marco@Marcos-MacBook-Pro.local>

docs/.vuepress/public/latest_version.html

@@ -1 +1 @@
-4.4.4
+1.4.0

docs/.vuepress/public/releases.json

@@ -1 +1 @@
-["1.1.0", "1.1.1", "1.1.2", "1.1.3", "1.1.4", "1.1.5", "1.1.6", "1.2.0", "1.2.1", "1.2.2", "1.2.3", "1.3.0", "1.3.1"]
+["1.1.0", "1.1.1", "1.1.2", "1.1.3", "1.1.4", "1.1.5", "1.1.6", "1.2.0", "1.2.1", "1.2.2", "1.2.3", "1.3.0", "1.3.1", "1.4.0"]

docs/.vuepress/site-config/sidebar-nav.js

@@ -1883,4 +1883,160 @@ module.exports = {
       ]
     }
   ],
+  "/docs/1.4.0/": [
+    {
+      title: "Introduction",
+      collapsable: true,
+      sidebarDepth: sidebarDepth,
+      path: "",
+      children: [
+        "overview/what-is-kuma",
+        "overview/what-is-a-service-mesh",
+        "overview/why-kuma",
+        "documentation/deployments",
+        "community/data-collection",
+        "other/enterprise",
+        "other/license",
+      ]
+    },
+    {
+      title: "Install",
+      collapsable: true,
+      sidebarDepth: sidebarDepth,
+      path: "",
+      children: [
+        "installation/kubernetes",
+        "installation/helm",
+        "installation/openshift",
+        "installation/docker",
+        "installation/amazonlinux",
+        "installation/ecs",
+        "installation/redhat",
+        "installation/centos",
+        "installation/debian",
+        "installation/ubuntu",
+        "installation/macos",
+      ]
+    },
+    {
+      title: "Deploy",
+      collapsable: true,
+      sidebarDepth: sidebarDepth,
+      path: "",
+      children: [
+        "quickstart/kubernetes",
+        "quickstart/universal",
+        "deployments/stand-alone",
+        "deployments/multi-zone",
+      ]
+    },
+    {
+      title: "Explore",
+      collapsable: true,
+      sidebarDepth: sidebarDepth,
+      path: "",
+      children: [
+        "documentation/overview",
+        "documentation/backends",
+        "documentation/dps-and-data-model",
+        "documentation/cli",
+        "documentation/gui",
+      ]
+    },
+    {
+      title: "Networking",
+      collapsable: true,
+      sidebarDepth: sidebarDepth,
+      path: "",
+      children: [
+        "networking/networking",
+        "networking/service-discovery",
+        "networking/dns",
+        "networking/cni",
+        "networking/transparent-proxying",
+        "networking/ipv6",
+      ]
+    },
+    {
+      title: "Security",
+      collapsable: true,
+      sidebarDepth: sidebarDepth,
+      path: "",
+      children: [
+        "security/certificates",
+        "security/secrets",
+        "security/api-access-control",
+        "security/api-server-auth",
+      ]
+    },
+    {
+      title: "Monitor & manage",
+      collapsable: true,
+      sidebarDepth: sidebarDepth,
+      path: "",
+      children: [
+        "documentation/health",
+        "documentation/fine-tuning",
+        "documentation/configuration",
+      ]
+    },
+    {
+      title: "Policies",
+      collapsable: true,
+      sidebarDepth: sidebarDepth,
+      path: "",
+      children: [
+        "policies/introduction",
+        "policies/general-notes-about-kuma-policies",
+        "policies/applying-policies",
+        "policies/how-kuma-chooses-the-right-policy-to-apply",
+        "policies/protocol-support-in-kuma",
+        "policies/mesh",
+        "policies/mutual-tls",
+        "policies/traffic-permissions",
+        "policies/traffic-route",
+        "policies/traffic-metrics",
+        "policies/traffic-trace",
+        "policies/traffic-log",
+        "policies/locality-aware",
+        "policies/fault-injection",
+        "policies/health-check",
+        "policies/circuit-breaker",
+        "policies/proxy-template",
+        "policies/external-services",
+        "policies/retry",
+        "policies/timeout",
+        "policies/rate-limit",
+        "policies/virtual-outbound"
+      ]
+    },
+    {
+      title: "Reference docs",
+      collapsable: true,
+      sidebarDepth: sidebarDepth,
+      path: "",
+      children: [
+        "documentation/http-api",
+        "documentation/kubernetes-annotations",
+        {
+          title: "Policy reference docs",
+          children: [
+            "generated/circuit-breaker",
+            "generated/external-service",
+            "generated/fault-injection",
+            "generated/health-check",
+            "generated/proxy-template",
+            "generated/rate-limit",
+            "generated/retry",
+            "generated/timeout",
+            "generated/traffic-log",
+            "generated/traffic-permissions",
+            "generated/traffic-route",
+            "generated/traffic-trace",
+            "generated/virtual-outbound",
+          ],
+        }
+      ]
+    }
+  ],
 }

docs/.vuepress/theme/global-components/CommunityCallForm.vue

@@ -59,6 +59,11 @@
             <span class="icon">📅</span> Add to Your Calendar
           </a>
         </li>
+        <li>
+          <a :href="recording" target="_blank">
+            <span class="icon">🎥</span> Past Recordings
+          </a>
+        </li>
       </ul>
     </div>
 

docs/README.md

@@ -46,7 +46,7 @@ carousel:
 
 ::: slot news
 
-**Kuma 1.3.1 has been released!** — Zones can now be disabled, dashboards let you select specific zones, performance improvements, and more! [Read More](/blog/2021/kuma-1-3-1/)
+**Kuma 1.4.0 has been released!** — User tokens replace client certificates for API authentication, locality-aware load balancing is now available for external services, we've renewed our commitment to ongoing performance improvements, and more! [Read More](/blog/2021/kuma-1-4-0/)
 
 :::
 

docs/_blog/2021-11-22-kuma-1-4-0.md

@@ -0,0 +1,41 @@
+---
+title: Kuma 1.4.0 GA Released With 2x Performance Improvements and 25+ New Features
+description: Kuma 1.4.0 GA Released With 2x Performance Improvements and 25+ New Features
+date: 2021-11-22
+tags:
+  - Release
+canonicalUrl: 'https://konghq.com/blog/kuma-1-4-0-released'
+---
+
+We are happy to announce a new release of Kuma! Kuma 1.4.0 is an new major release that ships with 25+ new features and significant performance improvements at scale. We strongly suggest to upgrade, in order to take advantage of the latest and greatest when it comes to service mesh.
+
+## Notable Features
+
+* 🚀 Performance is significantly improved, with ability to load 2x more data plane proxies, and less CPU consumption.
+* 🚀 The number of Postgres connections is now limited to 50 by default. The default value was previously unlimited; you can still configure the limit if needed.
+* 🚀 You can now disable zones as needed.
+* 🚀 You can now select a specific zone in the "Kuma Service" dashboard and in the "Service to Service" dashboard.
+* Internal DNS now properly resolves AAAA records.
+* Improvements to the GUI and its sidebar menu.
+
+And a lot more! The full changelog is available [here](https://github.com/kumahq/kuma/blob/master/CHANGELOG.md).
+
+![](/images/blog/zone_dropdown.png)
+
+_The new Zone dropdown in the Grafana dashboards_
+
+## Performance Improvements
+
+This release includes performance improvements that have been identified by our new performance suite which replicates a Kuma deployment at scale. This allows us to anticipate some performance issues that you may be experiencing in production and ship a fix as part of our continuous improvements to the product.
+
+Particularly, we have reduced the likelihood of overwhelming the underlying Postgres database in `universal` mode, and we are making incremental improvements to the CPU and memory consumption of Kuma. These performance improvements are our top priority, so please reach out to the maintainers if you would like to report any issue running Kuma at scale.
+
+## Join us on the community call!
+
+Join us on our [community channels](https://kuma.io/community/) to learn more about Kuma, including our official Slack chat. The community channels are useful to get up and running with Kuma, as well as to learn how to contribute to and discuss the project roadmap. Kuma is a CNCF Sandbox project: neutral, open and inclusive.
+
+The next community call will be hosted on [December 8th at 8:30am PDT](https://kuma.io/community/). Also don’t forget to follow Kuma [on Twitter](https://twitter.com/kumamesh) and star it [on GitHub](https://github.com/kumahq/kuma)!
+
+## Upgrading
+
+Be sure to carefully read the [Upgrade Guide](https://github.com/kumahq/kuma/blob/master/UPGRADE.md) before upgrading Kuma.

docs/community/README.md

@@ -49,7 +49,7 @@ can discuss and ask questions in real-time. If you have already joined, go direc
 
 ::: slot card-3-content
 Kuma hosts official monthly community calls where users and contributors can
-discuss about any topic and demonstrate use-cases. Interested? You can register below for the next Community Call.
+discuss topics and demonstrate use-cases. Interested? You can register below for the next Community Call.
 :::
 
 <!-- card 4 -->

docs/docs/1.2.0/policies/traffic-permissions.md

@@ -59,7 +59,7 @@ The `TrafficPermission` policy can also be used to restrict traffic to [services
 ### Prerequisites
 
 * Kuma deployed with [transparent proxying](../networking/transparent-proxying)
-* `Mesh` configured to [disable passthrough mode](docs/1.2.0/policies/mesh/#usage)
+* `Mesh` configured to [disable passthrough mode](/docs/1.2.0/policies/mesh/#usage)
 
 These settings lock down traffic to and from the mesh, which means that requests to any unknown destination are not allowed. The mesh can't rely on mTLS, because there is no data plane proxy on the destination side.
 

docs/docs/1.2.1/policies/traffic-permissions.md

@@ -59,7 +59,7 @@ The `TrafficPermission` policy can also be used to restrict traffic to [services
 ### Prerequisites
 
 * Kuma deployed with [transparent proxying](../networking/transparent-proxying)
-* `Mesh` configured to [disable passthrough mode](docs/1.2.1/policies/mesh/#usage)
+* `Mesh` configured to [disable passthrough mode](/docs/1.2.1/policies/mesh/#usage)
 
 These settings lock down traffic to and from the mesh, which means that requests to any unknown destination are not allowed. The mesh can't rely on mTLS, because there is no data plane proxy on the destination side.
 

docs/docs/1.2.2/policies/traffic-permissions.md

@@ -59,7 +59,7 @@ The `TrafficPermission` policy can also be used to restrict traffic to [services
 ### Prerequisites
 
 * Kuma deployed with [transparent proxying](../networking/transparent-proxying)
-* `Mesh` configured to [disable passthrough mode](docs/1.2.2/policies/mesh/#usage)
+* `Mesh` configured to [disable passthrough mode](/docs/1.2.2/policies/mesh/#usage)
 
 These settings lock down traffic to and from the mesh, which means that requests to any unknown destination are not allowed. The mesh can't rely on mTLS, because there is no data plane proxy on the destination side.
 

docs/docs/1.2.3/policies/traffic-permissions.md

@@ -59,7 +59,7 @@ The `TrafficPermission` policy can also be used to restrict traffic to [services
 ### Prerequisites
 
 * Kuma deployed with [transparent proxying](../networking/transparent-proxying)
-* `Mesh` configured to [disable passthrough mode](docs/1.2.3/policies/mesh/#usage)
+* `Mesh` configured to [disable passthrough mode](/docs/1.2.3/policies/mesh/#usage)
 
 These settings lock down traffic to and from the mesh, which means that requests to any unknown destination are not allowed. The mesh can't rely on mTLS, because there is no data plane proxy on the destination side.
 

docs/docs/1.3.0/policies/traffic-permissions.md

@@ -59,7 +59,7 @@ The `TrafficPermission` policy can also be used to restrict traffic to [services
 ### Prerequisites
 
 * Kuma deployed with [transparent proxying](../networking/transparent-proxying)
-* `Mesh` configured to [disable passthrough mode](docs/1.3.0/policies/mesh/#usage)
+* `Mesh` configured to [disable passthrough mode](/docs/1.3.0/policies/mesh/#usage)
 
 These settings lock down traffic to and from the mesh, which means that requests to any unknown destination are not allowed. The mesh can't rely on mTLS, because there is no data plane proxy on the destination side.
 

docs/docs/1.3.1/README.md

@@ -14,8 +14,6 @@ The word "Kuma" means "bear" in Japanese (クマ).
 
 The core maintainer of Kuma is **Kong**, the maker of the popular open-source Kong Gateway 🦍.
 
-There's a new docs page that explains how your Kuma deployment collects data: what data is collected, and how to turn off data collection. See [data collection](/docs/1.3.1/community/data-collection).
-
 ## Get started
 
 [Read about service mesh](/docs/1.3.1/overview/what-is-a-service-mesh/)

docs/docs/1.3.1/community/data-collection.md

@@ -1,6 +1,6 @@
 # Kuma data collection
 
-By default, Kuma collects some data about your deployment. This data is sent to Kong servers for storage and aggregation. You can disable data collection when you install the control plane.
+Kuma can collect some data about your deployment if enabled. Data collection (telemetry) is disabled by default. The collected data is sent to Kong servers for storage and aggregation. You can enable data collection when you install the control plane.
 
 ## Disable data collection on Kubernetes
 
@@ -12,7 +12,7 @@ By default, Kuma collects some data about your deployment. This data is sent to
 
 1.  Specify the environment variable when you install the control plane. See the [configuration docs](/docs/1.3.1/documentation/configuration/) for details.
 
-Or you can set the `reports.enabled` field to `false` in the config YAML file.
+Or you can set the `reports.enabled` field to `true` in the config YAML file.
 
 ## What data is collected
 

docs/docs/1.3.1/networking/service-discovery.md

@@ -1,10 +1,10 @@
 # Service Discovery
 
-Here we are going to be exploring the communication between `kuma-dp` and `kuma-cp`, and the communication between multiple `kuma-dp` to handle our service traffic.
+This page explains how communication between the components of Kuma handles service traffic. Communication is handled between the data plane proxy (`kuma-dp`) and the control plane (`kuma-cp`), and between multiple instances of the data plane proxy.
 
-Every time a data-plane (served by `kuma-dp`) connects to the control-plane, it initiates a gRPC streaming connection to Kuma (served by `kuma-cp`) in order to retrieve the latest policy configuration, and send diagnostic information to the control-plane.
+When a data plane proxy connects to the control-plane, it initiates a gRPC streaming connection to the control plane. It retrieves the latest policy configuration from the control plane and sends diagnostic information to the control plane.
 
-In [standalone mode](/docs/1.3.1/deployments/stand-alone/) the `kuma-dp` process will connect directly to the `kuma-cp` instances.
+In [standalone mode](/docs/1.3.1/deployments/stand-alone/) the `kuma-dp` process connects directly to the `kuma-cp` instances.
 
 In a [multi-zone deployment](/docs/1.3.1/deployments/multi-zone/) the `kuma-dp` processes will connect to the zone control plane, while the zone control planes will connect to the global control plane over an extension of the xDS API that we have built called "KDS" (Kuma Discovery Service). In multi-zone mode, the data plane proxies never connect to the global control plane but only to the zone ones.
 

docs/docs/1.4.0/README.md

@@ -0,0 +1,27 @@
+---
+title: Overview
+---
+
+# Welcome to Kuma
+
+Welcome to the official documentation for Kuma, a modern distributed **Control Plane** with a bundled Envoy Proxy integration.
+
+The word "Kuma" means "bear" in Japanese (クマ).
+
+<center>
+<img src="/images/diagrams/main-diagram@2x.png" alt="" style="width: 450px; padding-top: 10px"/>
+</center>
+
+The core maintainer of Kuma is **Kong**, the maker of the popular open-source Kong Gateway 🦍.
+
+## Get started
+
+[Read about service mesh](/docs/1.4.0/overview/what-is-a-service-mesh/)
+
+[Read about Kuma](/docs/1.4.0/overview/what-is-kuma/)
+
+[Install Kuma](/install/latest/)
+
+[Jump to the quickstart](/docs/1.4.0/quickstart/kubernetes/)
+
+[Explore the API](/docs/1.4.0/documentation/http-api/)

docs/docs/1.4.0/community/README.md

@@ -0,0 +1,7 @@
+# Community
+
+Kuma is an open-source product that can be downloaded and used freely in accordance to the Apache License Version 2.0.
+
+Community is at the DNA of Kuma. It is what makes Kuma better every day by either contributing or using the product.
+
+You can learn more about Kuma's community from the [Community Page](/community).

docs/docs/1.4.0/community/data-collection.md

@@ -0,0 +1,34 @@
+# Kuma data collection
+
+Kuma can collect some data about your deployment if enabled. Data collection (telemetry) is disabled by default. The collected data is sent to Kong servers for storage and aggregation. You can enable data collection when you install the control plane.
+
+## Disable data collection on Kubernetes
+
+1.  Set the following environment variable:
+
+    ```
+    KUMA_REPORTS_ENABLED=false
+    ```
+
+1.  Specify the environment variable when you install the control plane. See the [configuration docs](/docs/1.4.0/documentation/configuration/) for details.
+
+Or you can set the `reports.enabled` field to `true` in the config YAML file.
+
+## What data is collected
+
+| Data field | Definition | 
+|---|---|
+| version  | The installed version of Kuma you're running | 
+| product  | Static value "Kuma" | 
+| unique_id  | Control plane hostname + randon UUID, generated each time control plane instance is restarted | 
+| backend  | Where your config is stored. One of in memory, etcd, Postgres | 
+| mode    | One of standalone or multizone |
+| hostname | The hostname of each Kuma control plane you deploy |
+| signal | One of `start` or `ping`. `start` sent when control plane starts, then `ping` once per hour | 
+| cluster_id | Unique identifier for entire Kuma cluster. Value is the same for all control planes in the cluster |
+| dps_total | The total number of data plane proxies across all meshes | 
+| meshes_total | The total number of meshes deployed | 
+| zones_total | The total number of zones deployed | 
+| internal_services | Tne total number of services running inside your meshes | 
+| external_services | The total number of external services configured for your meshes |
+| services_ total | The total number of services in your mesh network |