refine README copy

Author: domalessi

octopus_deploy/README.md

@@ -2,67 +2,66 @@
 
 ## Overview
 
-This check monitors your [Octopus Deploy][1] deployments through the Datadog Agent. Track information such as average deployment time per Environment, and deployment failure rate for a Project.
+This check monitors your [Octopus Deploy][1] deployments through the Datadog Agent. Track information such as average deployment time per environment and deployment failure rate for a project.
 
 ## Setup
 
-Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the [Autodiscovery Integration Templates][3] for guidance on applying these instructions.
+Complete the following steps to install and configure this check on a host-based Agent. For containerized environments, see the [Autodiscovery Integration Templates][3] for guidance on applying these instructions.
 
 ### Installation
 
-The Octopus Deploy check is included in the [Datadog Agent][2] package.
-No additional installation is needed on your server.
+The Octopus Deploy check is included in the [Datadog Agent][2] package. No additional installation is needed.
 
 ### Configuration
 
 1. Create an [API key][10] on your Octopus Server.
 
-2. Edit the `octopus_deploy.d/conf.yaml` file in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your `octopus_deploy` performance data. See the [sample `octopus_deploy.d/conf.yaml`][4] for all available configuration options.
+2. Edit the `octopus_deploy.d/conf.yaml` file (located in the `conf.d/` folder at the root of your Agent's configuration directory) to start collecting `octopus_deploy` performance data. See the [sample config][4] for all available options.
 
- Ensure you limit the amount of projects you collect data for by using either the `spaces`, `project_groups`, or `projects` configuration options. For example, this configuration collects data about at most 10 projects, and only those projects whose names start with 'test':
+   **Note**: Limit the number of projects you collect data for by configuring **one** of the `spaces`, `project_groups`, or `projects` sections. For example, the following snippet limits collection to at most 10 projects whose names start with 'test':
 
-    ```
-    projects:
-        limit: 10
-        include:
-        - 'test.*'
-    ```
+   ```
+   projects:
+       limit: 10
+       include:
+       - 'test.*'
+   ```
 
 3. [Restart the Agent][5].
 
 #### Logs
 
-The Octopus deploy integration collects two types of logs: deployment logs and server logs.
+The Octopus Deploy integration collects two types of logs: deployment logs and server logs.
 
-##### Collecting Deployment Logs
+##### Collecting deployment logs
 
-Deployment logs are gathered from deployment tasks, useful for debugging failed deployments. To collect deployment logs, complete the following steps:
+Deployment logs are gathered from deployment tasks and are useful for debugging failed deployments. To collect deployment logs:
 
-1. Collecting logs is disabled by default in the Datadog Agent. Enable it in your `datadog.yaml` file:
+1. Enable log collection in your `datadog.yaml` file:
 
    ```yaml
    logs_enabled: true
    ```
 
-2. Uncomment and edit the logs configuration block in your `octopus_deploy.d/conf.yaml` file. Here's an example:
+2. Uncomment and edit the logs configuration block in your `octopus_deploy.d/conf.yaml` file. For example:
 
    ```yaml
    logs:
      - type: integration
        source: octopus_deploy
    ```
 
-##### Collecting Server Logs
+##### Collecting server logs
 
-Server logs are diagnostic information from the Octopus Server itself. They can only be collected when the Datadog Agent is running on same machine as the Octopus Server. To collect server logs, complete the following steps:
+Server logs are diagnostic information from the Octopus Server itself. They can only be collected when the Datadog Agent is running on the same machine as the Octopus Server. To collect server logs:
 
-1. Collecting logs is disabled by default in the Datadog Agent. Enable it in your `datadog.yaml` file:
+1. Enable log collection in your `datadog.yaml` file:
 
    ```yaml
    logs_enabled: true
    ```
 
-2. Uncomment and edit the logs configuration block in your `octopus_deploy.d/conf.yaml` file. Here's an example:
+2. Uncomment and edit the logs configuration block in your `octopus_deploy.d/conf.yaml` file. For example:
 
    ```yaml
    logs:
@@ -75,19 +74,19 @@ Server logs are diagnostic information from the Octopus Server itself. They can
 
 [Run the Agent's status subcommand][6] and look for `octopus_deploy` under the Checks section.
 
-## Data Collected
+## Data collected
 
 ### Metrics
 
 See [metadata.csv][7] for a list of metrics provided by this integration.
 
 ### Events
 
-The Octopus Deploy integration does not include any events.
+The Octopus Deploy integration does not include events.
 
-### Service Checks
+### Service checks
 
-The Octopus Deploy integration does not include any service checks.
+The Octopus Deploy integration does not include service checks.
 
 ## Troubleshooting