polish faq to suit
MODIFY
etcd/os-faq.md
etcd/os-faq.md
# etcd on Container Linux FAQ
-Are you planning on running etcd on CoreOS Container Linux? The following FAQ clarifies some common misconceptions.
+Questions often asked when using etcd v3 on CoreOS Container Linux
## What is the current version of etcd?
-[v3][etcd-latest-version].
+The version 3 series is the latest edition of the etcd binary and API. The [current release is the latest release in the version 3 series][etcd-latest-version].
## Where do I find etcd v3 in Container Linux?
-Container Linux includes a systemd service, [etcd-member.service][etcd-member-service], which pulls and runs a desired version of etcd (defaults to v3) in a rkt container. This functions as if the etcd binary was being run, but does not require the binary to be installed on your Container Linux node.
+Container Linux includes a systemd service, [etcd-member.service][etcd-member-service], that knows how to fetch and run etcd v3 in a Linux container. No etcd v3-series binary is directly included in the Container Linux filesystem.
-Newer versions of the etcd binary (v3) are not planned to be included in the OS.
+## Why is etcd v2 still part of the Container Linux filesystem?
-## Why is etcd v2 still in the os?
+For reasons of compatibility, previous, deprecated versions of etcd, named `etcd` and `etcd2`, are included in the Container Linux filesystem until they complete their [sunset schedules][etcd3-blog] and are finally removed.
-The etcd binary will be included in the OS until June, 2018.
+The etcd (v0) binary will be removed from Container Linux in May, 2017.
-The preferred way to run etcd in Container Linux is to use the etcd-member service mentioned above in the first question.
+The etcd2 binary will be included in the OS until June, 2018.
-## When will v3 be included in the OS image?
+The recommended way to run etcd on Container Linux is to use the etcd-member service.
-Never.
+## When will v3 be included in the OS image?
-Etcd v3 is shipped as a container and used via the etcd-member systemd service (see the first question for more information).
+Version 3-series etcd binaries are packaged in a Linux container and instantiated by the `etcd-member.service` systemd unit.
# Can I curl the v3 api?
-No.
-
-The etcd v3 API uses gRPC, which can not be interacted with via curl. Use etcdctl to interact with etcd clusters as this can be used to interact with a given cluster's v3 *and* v2 APIs.
-
-# How do I provision machines with etcd and config?
+No. The etcd v3 API uses gRPC rather than plain text HTTP. Use `etcdctl` to interact with the etcd v3 API.
-The preferred way to provision *any* Container Linux machine is to write a [Container Linux Config][clconfig]. This config allows easy configuration of networking, storage, users, docker, flannel, etcd, systemd, update channel, image verification, and locksmith.
+# How do I provision etcd cluster members?
-As part of the installation process, this YAML file is converted into an Ignition config. On first system boot the Container Linux node is configured into the desired state specified in the Container Linux Config. See an example of how to use this in the [Getting started with etcd][getting-started] guide.
+The preferred way to provision *any* Container Linux machine is with a [Container Linux Config][clconfig]. See an example Container Linux Config for etcd in the [getting started with etcd guide][getting-started].
# Can etcd be configured with cloud-config?
The preferred way to configure a Container Linux machine is with Container Linux configs and Ignition. The Container Linux Config Transpiler docs include [an etcd configuration example][clct-etcd-example].
-Cloud-Config is still a supported configuration method, however it does not have any etcd v3 specific support.
+[etcd3-blog]: https://coreos.com/blog/toward-etcd-v3-in-container-linux.html
[etcd-latest-version]: https://github.com/coreos/etcd/releases
[etcd-member-service]: https://github.com/coreos/coreos-overlay/blob/master/app-admin/etcd-wrapper/files/etcd-member.service
[getting-started]: https://coreos.com/etcd/docs/latest/getting-started-with-etcd.html

polish faq to suit