update READMEs

Author: oavdeev

README.md

@@ -1,14 +1,15 @@
 # Metaflow Terraform module
 
-Provides the core functionality for Metaflow which includes:
+Terraform module that provisions AWS resources to run [Metaflow](https://metaflow.org/) in production.
 
-- on demand processing (`computation`)
-- blob and tabular storage (`datastore`)
-- an API to record and query past executions (`metadata-service`)
-- orchestrated processing (`step-functions`)
-- other bits of infra like Amazon Elastic Container Registry (ECR) to hold the Docker image we wish to use with Metaflow.
+This module consists of submodules that can be used separately as well:
+
+- AWS Batch cluster to run Metaflow steps ([`metaflow-computation`](./modules/computation))
+- blob storage and metadata database ([`metaflow-datastore`](./modules/datastore))
+- a service providing API to record and query past executions ([`metaflow-metadata-service`](./modules/metadata-service))
+- resources to deploy Metaflow flows on Step Functions processing ([`metaflow-step-functions`](./modules/step-functions))
+- Metaflow UI([`metaflow-ui`](./modules/ui))
 
-This module is composed of submodules which break up the responsibility into logical parts listed above.
 You can either use this high-level module, or submodules individually. See each module's corresponding `README.md` for more details.
 
 This module requires an Amazon VPC to be set up by the module user beforehand. The output of the project `infra` is an example configuration of an Amazon VPC that can be passed to this module.

modules/computation/README.md

@@ -3,7 +3,7 @@
 This module sets up the resources to run Metaflow steps on AWS Batch. One can modify how many resources
 we want to have available, as well as configure autoscaling
 
-This module is not required to use Metaflow, as you can also run steps locally and leverage the Datastore
+This module is not required to use Metaflow, as you can also run steps locally, or in a Kubernetes cluster instead.
 
 To read more, see [the Metaflow docs](https://docs.metaflow.org/metaflow-on-aws/metaflow-on-aws#compute)
 

modules/metadata-service/README.md

@@ -1,6 +1,6 @@
 # Metadata Service
 
-The Metadata Service is a central store for the Metaflow metadata. Namely, it contains information about past runs, and pointers to data artifacts they produced. Metaflow client talks to the Metadata service over an HTTP API endpoint. Metadata service is not strictly required to use Metaflow, especially in the local mode, but it enables a lot of useful functionality, especially if there is more than person using Metaflow in your team.
+The Metadata Service is a central store for the Metaflow metadata. Namely, it contains information about past runs, and pointers to data artifacts they produced. Metaflow client talks to the Metadata service over an HTTP API endpoint. Metadata service is not strictly required to use Metaflow (you can use Metaflow in the "local" mode without it), but it enables a lot of useful functionality, especially if there is more than person using Metaflow in your team.
 
 This terraform module provisions infrastructure to run Metadata service on AWS Fargate.