Restructured Getting Started Section

content/docs/started/_index.md

@@ -3,3 +3,25 @@ title = "Getting Started"
 description = "How to get started using Kubeflow."
 weight = 20
 +++
+
+The guides in this section give detailed information about using Kubeflow and 
+its components.
+
+For best understanding of the guides, it's useful to have some knowledge of
+the following systems:
+
+* [Kubernetes](https://kubernetes.io/docs/tutorials/kubernetes-basics/)
+* [TensorFlow](https://www.tensorflow.org/get_started/)
+* [ksonnet](https://ksonnet.io/docs/tutorial)
+
+##### Kubeflow requirements
+
+ * ksonnet version {{% ksonnet-min-version %}} or later. See the 
+   [ksonnet component guide](/docs/components/ksonnet/) for details about
+   installing ksonnet.
+ * An existing Kubernetes cluster using Kubernetes version 
+   {{% kubernetes-min-version %}} or later:
+
+   * A minimum of 0.6 CPU in cluster (Reserved for 3 replicated ambassador pods and according to your need add additional CPUs)
+   * Node with storage >= 10 GB (Due to the ML libraries and third party packages being bundled in Kubeflow Docker images)
+

content/docs/started/cloud/_index.md

@@ -0,0 +1,5 @@
++++
+title = "Cloud Installation"
+description = "Get started with Kubeflow on a cloud provider"
+weight = 1
++++

content/docs/started/getting-started-aws.md → content/docs/started/cloud/getting-started-aws.md

@@ -1,5 +1,5 @@
 +++
-title = "AWS for Kubeflow"
+title = "Kubeflow on AWS"
 description = "Get Kubeflow running on Amazon Web Services (AWS)"
 weight = 2
 +++

content/docs/started/getting-started-azure.md → content/docs/started/cloud/getting-started-azure.md

@@ -1,4 +1,4 @@
-+++ title = "Azure for Kubeflow" 
++++ title = "Kubeflow on Azure"
 description = "Get Kubeflow running on Microsoft Azure" 
 weight = 2
 +++

content/docs/started/getting-started-gke.md → content/docs/started/cloud/getting-started-gke.md

@@ -1,5 +1,5 @@
 +++
-title = "Google Cloud for Kubeflow"
+title = "Kubeflow on Google Cloud"
 description = "Get Kubeflow running on Google Cloud Platform (GCP)"
 weight = 2
 +++

content/docs/started/getting-started-icp.md → content/docs/started/cloud/getting-started-icp.md

@@ -1,5 +1,5 @@
 +++
-title = "IBM Cloud Private for Kubeflow"
+title = "Kubeflow on IBM Cloud Private"
 description = "Get Kubeflow running on IBM Cloud Private"
 weight = 2
 +++

content/docs/started/local/_index.md

@@ -0,0 +1,48 @@
++++
+title = "Local Installation"
+description = "Get started with Kubeflow on local hardware"
+weight = 1
++++
+
+   * [MiniKF](/docs/started/local/getting-started-minikf/)
+      * MiniKF is a fast and easy way to get started with Kubeflow.
+      * It installs with just two commands and then you are up for
+	      experimentation, and for running complete Kubeflow Pipelines.
+      * MiniKF runs on all major operating systems (Linux, macOS, Windows).
+
+   * [Minikube](/docs/started/local/getting-started-minikube/)
+      * Minikube uses virtualization applications like 
+        [VirtualBox](https://www.virtualbox.org/) or [VMware
+        Fusion](https://www.vmware.com/products/fusion.html) to host the VM
+	      and provides a CLI that you can use outside the VM.
+      * Minikube defines a fully-baked
+       [ISO image](https://en.wikipedia.org/wiki/ISO_image) that contains a
+        minimal operating system and Kubernetes already installed.
+      * This option may be useful if you are just starting to learn and already
+	      have one of the virtualization applications installed.
+
+   * [MicroK8s](/docs/started/local/getting-started-multipass/)
+      * [MicroK8s](https://microk8s.io/) can provide the following benefits:
+          - A small, fast, secure, single node Kubernetes installation that installs on any
+            Linux system as a [snap](https://snapcraft.io/microk8s).
+          - Strong isolation and update semantics - your cluster
+            is updated within a short period after upstream Kubernetes
+            releases.
+          - Built-in support to enable an installed GPU:
+            `microk8s.enable gpu`
+      * MicroK8s requires Linux. If you are not on a Linux machine, or you want
+        to confine your Kubeflow to a disposable machine, the installation guide
+        show you how to use
+        [Multipass](https://github.com/CanonicalLtd/multipass) to launch a VM.
+        Benefits include:
+          - [Ubuntu Cloud Images](http://cloud-images.ubuntu.com/) already
+            integrated.
+          - Lightweight hypervisor using native operating system mechanisms
+            (for example, [Hypervisor
+            Framework](https://developer.apple.com/documentation/hypervisor) on
+            macOS, [Hyper-V on Windows
+            10](https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v), or
+            QEMU/KVM for Linux).
+          - No need to install a separate virtualization application.
+          - Use of `cloud-init` to customize the VM.
+

content/docs/started/getting-started-minikube.md → content/docs/started/local/getting-started-minikube.md

@@ -1,5 +1,5 @@
 +++
-title = "Minikube for Kubeflow"
+title = "Kubeflow on Minikube"
 description = "Quickly get Kubeflow running locally"
 weight = 2
 +++
@@ -248,4 +248,4 @@ notebooks at http://localhost:8080/notebooks/.
 For Jupyter notebooks, you can use any username and password to log in. 
 Follow the guide to [setting up your Jupyter notebooks on Kubeflow](/docs/notebooks/setup/).
 
-For further exploration refer to the [documentation](/docs/).
+For further exploration refer to the [documentation](/docs/).

content/docs/started/getting-started-multipass.md → content/docs/started/local/getting-started-multipass.md

@@ -1,5 +1,5 @@
 +++
-title = "Microk8s for Kubeflow"
+title = "Kubeflow on Microk8s"
 description = "Quickly get Kubeflow running locally on native hypervisors"
 weight = 2
 +++

content/docs/started/on-prem/_index.md

@@ -0,0 +1,5 @@
++++
+title = "On-Prem Installation"
+description = "Get started with Kubeflow On-Prem"
+weight = 1
++++

content/docs/started/getting-started-k8s.md → content/docs/started/on-prem/getting-started-k8s.md

@@ -1,5 +1,5 @@
 +++
-title = "Kubeflow on Kubernetes"
+title = "Kubeflow on an Existing Kubernetes Cluster"
 description = "Instructions for installing Kubeflow on your existing Kubernetes cluster"
 weight = 4
 +++
@@ -183,4 +183,4 @@ Your Kubeflow app directory contains the following files and directories:
   UIs](/docs/other-guides/accessing-uis/), where you can manage various 
   aspects of your Kubeflow deployment.
 * Run a [sample machine learning workflow](/docs/examples/resources/).
-* Get started with [Kubeflow Pipelines](/docs/pipelines/pipelines-quickstart/)
+* Get started with [Kubeflow Pipelines](/docs/pipelines/pipelines-quickstart/).