Merge pull request #1472 from bigchaindb/move-some-docs-around

Docs: Moved Old Cloud Deployment Templates to the Appendices & Edited Introductions

docs/server/source/appendices/azure-quickstart-template.md

@@ -1,6 +1,6 @@
 # Azure Quickstart Template
 
-If you didn't read the introduction to the [cloud deployment templates](index.html), please do that now. The main point is that they're not for deploying a production node; they can be used as a starting point.
+This page outlines how to run a single BigchainDB node on the Microsoft Azure public cloud, with RethinkDB as the database backend. It uses an Azure Quickstart Template. That template is dated because we now recommend using MongoDB instead of RethinkDB. That's why we moved this page to the Appendices.
 
 Note: There was an Azure quickstart template in the `blockchain` directory of Microsoft's `Azure/azure-quickstart-templates` repository on GitHub. It's gone now; it was replaced by the one described here.
 

docs/server/source/appendices/index.rst

@@ -18,6 +18,9 @@ Appendices
    backend
    commands
    aws-setup
+   template-terraform-aws
+   template-ansible
+   azure-quickstart-template
    generate-key-pair-for-ssh
    firewall-notes
    ntp-notes

docs/server/source/appendices/template-ansible.md

@@ -1,9 +1,9 @@
 # Template: Ansible Playbook to Run a BigchainDB Node on an Ubuntu Machine
 
-If you didn't read the introduction to the [cloud deployment templates](index.html), please do that now. The main point is that they're not for deploying a production node; they can be used as a starting point.
-
 This page explains how to use [Ansible](https://www.ansible.com/) to install, configure and run all the software needed to run a one-machine BigchainDB node on a server running Ubuntu 16.04.
 
+**Note: We're not actively maintaining the associated Ansible files (e.g. playbooks). They are RethinkDB-specific, even though we now recommend using MongoDB. You may find the old Ansible stuff useful nevertheless, which is why we moved this page to the Appendices rather than deleting it.**
+
 
 ## Install Ansible
 

docs/server/source/appendices/template-terraform-aws.md

@@ -1,8 +1,8 @@
 # Template: Using Terraform to Provision an Ubuntu Machine on AWS
 
-If you didn't read the introduction to the [cloud deployment templates](index.html), please do that now. The main point is that they're not for deploying a production node; they can be used as a starting point.
+This page explains a way to use [Terraform](https://www.terraform.io/) to provision an Ubuntu machine (i.e. an EC2 instance with Ubuntu 16.04) and other resources on [AWS](https://aws.amazon.com/). That machine can then be used to host a one-machine BigchainDB node, for example.
 
-This page explains a way to use [Terraform](https://www.terraform.io/) to provision an Ubuntu machine (i.e. an EC2 instance with Ubuntu 16.04) and other resources on [AWS](https://aws.amazon.com/). That machine can then be used to host a one-machine BigchainDB node.
+**Note: We're not actively maintaining the associated Terraform files. You may find them useful nevertheless, which is why we moved this page to the Appendices rather than deleting it.**
 
 
 ## Install Terraform

docs/server/source/cloud-deployment-templates/index.rst

@@ -1,11 +1,14 @@
-Cloud Deployment Templates
-==========================
+Production Deployment Template
+==============================
 
-We have some "templates" to deploy a basic, working, but bare-bones BigchainDB node on various cloud providers. They should *not* be used as-is to deploy a node for production. They can be used as a starting point.
+This section outlines how *we* deploy production BigchainDB nodes and clusters
+on Microsoft Azure
+using Kubernetes.
+We improve it constantly.
+You may choose to use it as a template or reference for your own deployment,
+but *we make no claim that it is suitable for your purposes*.
+Feel free change things to suit your needs or preferences.
 
-You don't have to use the tools we use in the templates. You can use whatever tools you prefer.
-
-If you find the cloud deployment templates for nodes helpful, then you may also be interested in our scripts for :doc:`deploying a testing cluster on AWS <../clusters-feds/aws-testing-cluster>` (documented in the Clusters section).
 
 .. toctree::
    :maxdepth: 1
@@ -15,9 +18,6 @@ If you find the cloud deployment templates for nodes helpful, then you may also
    server-tls-certificate
    client-tls-certificate
    revoke-tls-certificate
-   template-terraform-aws
-   template-ansible
-   azure-quickstart-template
    template-kubernetes-azure
    node-on-kubernetes
    add-node-on-kubernetes

docs/server/source/index.rst

@@ -7,14 +7,14 @@ BigchainDB Server Documentation
    ← Back to All BigchainDB Docs <https://docs.bigchaindb.com/en/latest/index.html>
    introduction
    quickstart
-   cloud-deployment-templates/index
    production-nodes/index
+   clusters-feds/index
+   cloud-deployment-templates/index
    dev-and-test/index
    server-reference/index
    http-client-server-api
    websocket-event-stream-api
    drivers-clients/index
-   clusters-feds/index
    data-models/index
    schema/transaction
    schema/vote