Add machine controller documentation (#1696)

* add MC content

* add external-code renderer shortcode

* config updates

* fix typos

* add share image

* add blurp

* PR feedback

* remove outdated docs

* move docs into a main/ directory in anticipation of the upcoming 2.x lineage

* move docs for setting up vSphere Template VMs to the MC docs

* more cleanup

* restructure vsphere template VM docs

* more PR feedback

* move guide

Author: xrstf

config.toml

@@ -77,7 +77,7 @@ url = "https://twitter.com/Kubermatic"
 class = "fab fa-twitter"
 
 [[params.socials]]
-url = "https://github.com/kubermatic/"
+url = "https://github.com/kubermatic"
 class = "fab fa-github"
 
 [[params.socials]]

content/_index.md

@@ -6,13 +6,13 @@ description = "Learn more about KKP and KubeOne through the official Kubermatic
 title = "How Do I Contribute To ...?"
 
   [[contribution.links]]
-  url = "https://docs.kubermatic.com/kubeone/v1.7/tutorials/how-to-contribute-to-kubeone/"
+  url = "https://docs.kubermatic.com/kubeone/v1.8/tutorials/how-to-contribute-to-kubeone/"
   [contribution.links.image]
   src = "/img/logo-kubeone.svg"
   alt = ""
 
   [[contribution.links]]
-  url = "https://docs.kubermatic.com/kubermatic/v2.24/how-to-contribute-to-kkp/"
+  url = "https://docs.kubermatic.com/kubermatic/v2.25/how-to-contribute-to-kkp/"
   [contribution.links.image]
   src = "/img/logo-kubermatic.svg"
   alt = ""

content/machine-controller/_index.en.md

@@ -0,0 +1,6 @@
++++
+title = "machine-controller Docs"
+sitemapexclude = true
++++
+
+Manage machines at cloud providers using a declarative Kubernetes API, compatible with the Kubernetes cluster-autoscaler.

content/machine-controller/main/_index.en.md

@@ -0,0 +1,60 @@
++++
+title = "machine-controller"
+date = 2024-05-31T07:00:00+02:00
++++
+
+# machine-controller
+
+## Features
+
+### What Works
+
+- Creation of worker nodes on…
+  - Alibaba Cloud
+  - AWS
+  - Azure
+  - DigitalOcean
+  - Google Cloud Platform
+  - Hetzner Cloud
+  - KubeVirt
+  - Nutanix
+  - OpenStack
+  - VMware Cloud Director
+  - VMware vSphere
+- Using any of these supported distributions ([not all distributions work on all providers](/docs/operating-system.md):
+  - Amazon Linux 2
+  - Flatcar Linux
+  - RedHat Enterprise Linux (RHEL)
+  - Rocky Linux
+  - Ubuntu
+
+### What Doesn't Work
+
+- Creation of control plane nodes (not planned at the moment, consider using 3rd party tools like
+  [KKP](https://github.com/kubermatic/kubermatic) or [KubeOne](https://github.com/kubermatic/kubeone))
+
+## Supported Kubernetes Versions
+
+machine-controller tries to follow the Kubernetes version
+[support policy](https://kubernetes.io/docs/setup/release/version-skew-policy/) as close as possible.
+
+Currently supported Kubernetes versions are:
+
+- 1.31
+- 1.30
+- 1.29
+- 1.28
+
+## Community Providers
+
+Some cloud providers implemented in machine-controller have been graciously contributed by community
+members. Those cloud providers are not part of the automated end-to-end tests run by the
+machine-controller developers and thus, their status cannot be guaranteed. The machine-controller
+developers assume that they are functional, but can only offer limited support for new features or
+bugfixes in those providers.
+
+The current list of community providers is:
+
+- Linode
+- Vultr
+- OpenNebula