kubedb · tamalsaha · Jul 19, 2017 · Jul 19, 2017 · Jul 19, 2017 · Jul 19, 2017
diff --git a/README.md b/README.md
@@ -1,5 +1,5 @@
 # KubeDB
-Running production quality database in Kubernetes can be tricky to say the least. In the early days of Kubernetes, replication controllers were used to run a single pod for a database. With the introduction of StatefulSet, it became easy to run a docker container for any database. But what about monitoring, taking periodic backups, restoring from backups or cloning from an existing database? KubeDB by AppsCode is a framework for writing operators for any database that support the following operational requirements:
+Running production quality database in Kubernetes can be tricky to say the least. In the early days of Kubernetes, replication controllers were used to run a single pod for a database. With the introduction of StatefulSet, it became easy to run a docker container for any database. But what about monitoring, taking periodic backups, restoring from backups or cloning from an existing database? KubeDB is a framework for writing operators for any database that support the following operational requirements:
 
  - Create a database declaratively using TPR
  - Take one-off backups or period backups to various cloud stores, eg,, S3, GCS, etc.
@@ -9,7 +9,7 @@ Running production quality database in Kubernetes can be tricky to say the least
  - Keep track of deleted databases, cleanup prior snapshots with a single command.
  - Use cli to manage databases like kubectl for Kubernetes.
 
-Currently we include a complete implementation for Postgres and ElasticSearch database based on KubeDB framework.
+KubeDB is developed at AppsCode Inc. to run their SAAS platform on Kubernetes. Currently we include a complete implementations for Postgres and ElasticSearch database based on K8sdb framework.
 
 ## Supported Versions
 Kubernetes 1.5+
@@ -18,7 +18,7 @@ Kubernetes 1.5+
 To install KubeDB, please follow the guide [here](/docs/install.md).
 
 ## Using KubeDB
-Want to learn how to use KubeDB? Please start [here](/docs/tutorial.md).
+Want to learn how to use KubeDB? Please start [here](/docs/tutorials/README.md).
 
 ## Contribution guidelines
 Want to help improve KubeDB? Please start [here](/CONTRIBUTING.md).

diff --git a/docs/README.md b/docs/README.md
@@ -18,7 +18,7 @@ Kubernetes 1.5+
 To install KubeDB, please follow the guide [here](/docs/install.md).
 
 ## Using KubeDB
-Want to learn how to use KubeDB? Please start [here](/docs/tutorial.md).
+Want to learn how to use KubeDB? Please start [here](/docs/tutorials/README.md).
 
 ## Contribution guidelines
 Want to help improve KubeDB? Please start [here](/CONTRIBUTING.md).

diff --git a/docs/concepts/elasticsearch.md b/docs/concepts/elasticsearch.md
@@ -1,4 +1,4 @@
-> New to KubeDB? Please start [here](/docs/tutorial.md).
+> New to KubeDB? Please start [here](/docs/tutorials/README.md).
 
 # Elasticsearch
 

diff --git a/docs/concepts/monitoring.md b/docs/concepts/monitoring.md
@@ -1,4 +1,4 @@
-> New to KubeDB? Please start [here](/docs/tutorial.md).
+> New to KubeDB? Please start [here](/docs/tutorials/README.md).
 
 # Monitoring KubeDB
 

diff --git a/docs/concepts/postgres.md b/docs/concepts/postgres.md
@@ -1,6 +1,6 @@
-> New to KubeDB? Please start [here](/docs/tutorial.md).
+> New to KubeDB? Please start [here](/docs/tutorials/README.md).
 
-# Postgreses
+# Postgres
 
 ## What is Postgres
 A `Postgres` is a Kubernetes `Third Party Object` (TPR). It provides declarative configuration for [PostgreSQL](https://www.postgresql.org/) in a Kubernetes native way. You only need to describe the desired database configuration in a Postgres object, and the KubeDB operator will create Kubernetes objects in the desired state for you.

diff --git a/docs/concepts/snapshot.md b/docs/concepts/snapshot.md
@@ -1,6 +1,6 @@
-> New to KubeDB? Please start [here](/docs/tutorial.md).
+> New to KubeDB? Please start [here](/docs/tutorials/README.md).
 
-# Snapshots
+# Snapshot
 
 ## What is Snapshot
 A `Snapshot` is a Kubernetes `Third Party Object` (TPR). It provides declarative configuration for database snapshots in a Kubernetes native way. 
@@ -34,7 +34,7 @@ spec:
       cpu: "500m"
 ```
 
-The `.spec` section supports the following different cloud providers to store snapshot data:
+The `.spec` section supports the following different storage providers for storing snapshot data:
 
 ### Local
 `Local` backend refers to a local path inside snapshot job container. Any Kubernetes supported [persistent volume](https://kubernetes.io/docs/concepts/storage/volumes/) can be used here. Some examples are: `emptyDir` for testing, NFS, Ceph, GlusterFS, etc.
@@ -422,52 +422,3 @@ spec:
       memory: "128Mi"
       cpu: "500m"
 ```
-
-
-## Taking one-off Backup
-To initiate backup process, first create a Snapshot object. A valid Snapshot object must contain the following fields:
-
- - metadata.name
- - metadata.namespace
- - metadata.labels[kubedb.com/kind]
- - spec.databaseName
- - spec.storageSecretName
- - spec.local | spec.s3 | spec.gcs | spec.azure | spec.swift
-
-Before starting backup process, KubeDB operator will validate storage secret by creating an empty file in specified bucket using this secret.
-
-Using `kubedb`, create a Snapshot object from `snapshot.yaml`.
-
-```console
-$ kubedb create -f ./docs/examples/elasticsearch/snapshot.yaml
-
-snapshot "snapshot-xyz" created
-```
-
-Use `kubedb get` to check snap0shot status.
-
-```console
-$ kubedb get snap snapshot-xyz -o wide
-
-NAME           DATABASE              BUCKET         STATUS      AGE
-snapshot-xyz   es/elasticsearch-db   s3:snapshot    Succeeded   24m
-```
-
-
-## Schedule Backups
-Scheduled backups are supported for all types of databases. To schedule backups, add the following `BackupScheduleSpec` in `spec` of a database tpr.
-All snapshot storage backends are supported for scheduled backup.
-
-```yaml
-spec:
-  backupSchedule:
-    cronExpression: "@every 6h"
-    storageSecretName: "secret-for-bucket"
-    s3:
-      endpoint: 's3.amazonaws.com'
-      bucket: kubedb-qa
-```
-
-`spec.backupSchedule.schedule` is a [cron expression](https://github.com/robfig/cron/blob/v2/doc.go#L26) that indicates how often backups are taken.
-
-When `spec.backupSchedule` section is added, KubeDB operator immediately takes a backup to validate this information. After that, at each tick kubeDB operator creates a Snapshot object. This triggers operator to create a Job to take backup.
diff --git a/docs/install.md b/docs/install.md
@@ -1,4 +1,4 @@
-> New to KubeDB? Please start [here](/docs/tutorial.md).
+> New to KubeDB? Please start [here](/docs/tutorials/README.md).
 
 # Installation Guide
 
@@ -60,7 +60,7 @@ Now, to confirm TPR groups have been registered by the operator, run the followi
 $ kubectl get thirdpartyresources -l app=kubedb
 ```
 
-Now, you are ready to [create your first database](/docs/tutorial.md) using KubeDB.
+Now, you are ready to [create your first database](/docs/tutorials/README.md) using KubeDB.
 
 ## Upgrade KubeDB
 To upgrade KubeDB cli, just replace the old cli with the new version.

diff --git a/docs/tutorial.md b/docs/tutorial.md
diff --git a/docs/tutorials/cli.md b/docs/tutorials/cli.md
@@ -1,4 +1,4 @@
-> New to KubeDB? Please start [here](/docs/tutorial.md).
+> New to KubeDB? Please start [here](/docs/tutorials/README.md).
 
 # Manage KubeDB objects using CLIs
 
@@ -308,3 +308,10 @@ $ kubectl get postgres.kubedb.com
 # Delete objects
 $ kubectl delete postgres <name>
 ```
+
+
+## Next Steps
+- Learn how to use KubeDB to run a PostgreSQL database [here](/docs/tutorials/postgres.md).
+- Learn how to use KubeDB to run an Elasticsearch database [here](/docs/tutorials/elasticsearch.md).
+- Wondering what features are coming next? Please visit [here](/ROADMAP.md). 
+- Want to hack on Stash? Check our [contribution guidelines](/CONTRIBUTING.md).
diff --git a/docs/tutorials/elasticsearch.md b/docs/tutorials/elasticsearch.md
@@ -606,3 +606,12 @@ $ kubectl delete ns demo
 ```
 
 If you would like to uninstall KubeDB operator, please follow the steps [here](/docs/uninstall.md).
+
+
+## Next Steps
+- Learn about the details of Elasticsearch tpr [here](/docs/concepts/elasticsearch.md).
+- See the list of supported storage providers for snapshots [here](/docs/concepts/snapshot.md).
+- Thinking about monitoring your database? KubeDB works [out-of-the-box with Prometheus](/docs/tutorials/monitoring.md).
+- Learn how to use KubeDB in a [RBAC](/docs/concepts/rbac.md) enabled cluster.
+- Wondering what features are coming next? Please visit [here](/ROADMAP.md). 
+- Want to hack on Stash? Check our [contribution guidelines](/CONTRIBUTING.md).
diff --git a/docs/tutorials/monitoring.md b/docs/tutorials/monitoring.md
@@ -184,3 +184,11 @@ $ kubectl delete ns demo
 ```
 
 If you would like to uninstall KubeDB operator, please follow the steps [here](/docs/uninstall.md).
+
+
+## Next Steps
+- Learn about the details of monitoring support [here](/docs/concepts/monitoring.md).
+- Learn how to use KubeDB to run a PostgreSQL database [here](/docs/tutorials/postgres.md).
+- Learn how to use KubeDB to run an Elasticsearch database [here](/docs/tutorials/elasticsearch.md).
+- Wondering what features are coming next? Please visit [here](/ROADMAP.md). 
+- Want to hack on Stash? Check our [contribution guidelines](/CONTRIBUTING.md).
diff --git a/docs/tutorials/postgres.md b/docs/tutorials/postgres.md
@@ -648,3 +648,12 @@ $ kubectl delete ns demo
 ```
 
 If you would like to uninstall KubeDB operator, please follow the steps [here](/docs/uninstall.md).
+
+
+## Next Steps
+- Learn about the details of Postgres tpr [here](/docs/concepts/postgres.md).
+- See the list of supported storage providers for snapshots [here](/docs/concepts/snapshot.md).
+- Thinking about monitoring your database? KubeDB works [out-of-the-box with Prometheus](/docs/tutorials/monitoring.md).
+- Learn how to use KubeDB in a [RBAC](/docs/concepts/rbac.md) enabled cluster.
+- Wondering what features are coming next? Please visit [here](/ROADMAP.md). 
+- Want to hack on Stash? Check our [contribution guidelines](/CONTRIBUTING.md).
diff --git a/docs/tutorials/rbac.md b/docs/tutorials/rbac.md
@@ -270,3 +270,10 @@ $ kubectl delete ns demo
 ```
 
 If you would like to uninstall KubeDB operator, please follow the steps [here](/docs/uninstall.md).
+
+
+## Next Steps
+- Learn how to use KubeDB to run a PostgreSQL database [here](/docs/tutorials/postgres.md).
+- Learn how to use KubeDB to run an Elasticsearch database [here](/docs/tutorials/elasticsearch.md).
+- Wondering what features are coming next? Please visit [here](/ROADMAP.md). 
+- Want to hack on Stash? Check our [contribution guidelines](/CONTRIBUTING.md).
diff --git a/docs/uninstall.md b/docs/uninstall.md
@@ -1,4 +1,4 @@
-> New to KubeDB? Please start [here](/docs/tutorial.md).
+> New to KubeDB? Please start [here](/docs/tutorials/README.md).
 
 # Uninstall KubeDB
 Please follow the steps below to uninstall KubeDB: