Merge pull request #773 from newrelic/edit-pass

Edit pass

Author: alexronquillo

src/markdown-pages/automate-workflows/get-started-new-relic-cli.mdx

@@ -23,7 +23,7 @@ tags:
 
 <Intro>
 
-Access the New Relic platform from the comfort of your terminal: you can use the New Relic CLI to manage entity tags, define workloads, record deployment markers, and much more. Our CLI has been designed for automating common tasks in your DevOps workflow. This guide walks you through the essentials of New Relic CLI, from install and configuration to basic usage.
+Access the New Relic platform from the comfort of your terminal. You can use the New Relic CLI to manage entity tags, define workloads, record deployment markers, and much more. In short, you can use the CLI to automate common tasks in your DevOps workflow. This guide walks you through the essentials of New Relic CLI, from install and configuration to basic usage.
 
 <Video id="6uw3tu0d23" type="wistia"/>
 </Intro>
@@ -32,45 +32,45 @@ Access the New Relic platform from the comfort of your terminal: you can use the
 
 For this guide you just need:
 
-1. A New Relic [user key](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#user-api-key): you can create this from the [API keys UI](https://one.newrelic.com/launcher/api-keys-ui.api-keys-launcher)
-2. An [instrumented application](https://docs.newrelic.com/docs/agents/manage-apm-agents/installation/install-agent) in your New Relic account
+- Your New Relic [personal API Key](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#personal-api-key), which you can create from the **Account settings** of your New Relic account
+- An [instrumented application](https://docs.newrelic.com/docs/agents/manage-apm-agents/installation/install-agent) in your New Relic account
 
 <Steps>
 <Step>
 
-## Install the New Relic CLI
+Install the New Relic CLI
 
-The New Relic CLI can be downloaded via [Homebrew](https://brew.sh/) (macOS), [Scoop](https://scoop.sh/) (Windows), and [Snapcraft](https://snapcraft.io/) (Linux). You can also download [pre-built binaries](https://github.com/newrelic/newrelic-cli/releases) for all platforms, including .deb and .rpm packages, and our Windows x64 .msi installer.
+Download the New Relic CLI for your operating system, as described below. You can also download [pre-built binaries](https://github.com/newrelic/newrelic-cli/releases) for all platforms, including .deb and .rpm packages, and our Windows x64 .msi installer.
 
-### Linux
+**Linux**
 
 <>
 
-With [Snapcraft](https://snapcraft.io/) installed, run:
+Using [Snapcraft](https://snapcraft.io/), run:
 
 ```sh
 sudo snap install newrelic-cli
 ```
 
 </>
 
-### macOS
+**macOS**
 
 <>
 
-With [Homebrew](https://brew.sh/) installed, run:
+Using [Homebrew](https://brew.sh/), run:
 
 ```sh
 brew install newrelic-cli
 ```
 
 </>
 
-### Windows
+**Windows**
 
 <>
 
-With [Scoop](https://scoop.sh/) installed, run:
+Using [Scoop](https://scoop.sh/), run:
 
 ```sh
 scoop bucket add newrelic-cli https://github.com/newrelic/newrelic-cli.git
@@ -81,11 +81,11 @@ scoop install newrelic-cli
 
 </Step><Step>
 
-## Create your New Relic CLI profile
+Create your New Relic CLI profile.
 
-Now that you've installed the New Relic CLI, it's time to create your first profile. Profiles contain credentials and settings that you can apply to any CLI command, which is useful when switching between accounts.
+After you install the New Relic CLI, it's time to create your first profile. Profiles contain credentials and settings that you can apply to any CLI command, which is useful when switching between accounts.
 
-To create your first CLI profile, run the [`profiles add`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_profile_add.md) command. Note that you need to set the [region](https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/get-started/our-eu-us-region-data-centers) of your New Relic account: use `-r` to set either `us` or `eu` (this is required).
+Run the [`profiles add`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_profile_add.md) command:
 
 ```sh lineNumbers=false
 # Create the tutorial account for the US region
@@ -94,29 +94,41 @@ newrelic profiles add -n tutorial --apiKey YOUR_NEW_RELIC_USER_KEY -r YOUR_REGIO
 newrelic profiles default -n tutorial
 ```
 
+<Callout variant="important">
+
+You must set the [region](https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/get-started/our-eu-us-region-data-centers) of your New Relic account. Use `-r` to set either `us` or `eu`.
+
+</Callout>
+
 </Step><Step>
 
-## Get your application details
+Get your application details.
 
-In this example, you are going to add tags to the application you've instrumented with New Relic. [Tags](https://docs.newrelic.com/docs/new-relic-one/use-new-relic-one/core-concepts/tagging-use-tags-organize-group-what-you-monitor) are key-value pairs that can help you organize and filter your entities. An [entity](https://docs.newrelic.com/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic) (for example, an application) can have a maximum of 100 key-value pairs tied to it.
+Now, add tags to the application you've instrumented with New Relic. [Tags](https://docs.newrelic.com/docs/new-relic-one/use-new-relic-one/core-concepts/tagging-use-tags-organize-group-what-you-monitor) are key-value pairs that can help you organize and filter your entities. An [entity](https://docs.newrelic.com/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic) (for example, an application) can have a maximum of 100 key-value pairs tied to it.
 
 Before searching for your application using the New Relic CLI, write down or copy your [Account ID](https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/account-id) and the [name of your application in New Relic](https://docs.newrelic.com/docs/agents/manage-apm-agents/app-naming/name-your-application) - you need both to find applications in the New Relic platform.
 
 </Step><Step>
 
-The New Relic CLI can retrieve your application details as a JSON object.
+Retrieve your application details as a JSON object.
 
-To search for your APM application use the [`apm application search`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_apm_application_search.md) command. If you get an error, check that the account ID and application name you provided are correct.
+To search for your APM application, use the [`apm application search`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_apm_application_search.md) command:
 
 ```bash lineNumbers=false
 newrelic apm application search --accountId YOUR_ACCOUNT_ID --name NAME_OF_YOUR_APP
 ```
 
+<Callout variant="tip">
+
+If you get an error, check that your account ID and application name are correct.
+
+</Callout>
+
 </Step><Step>
 
-If the account ID is valid, and the application name exists in your account, `apm application search` yields data similar to this example.
+Find the `guid` value.
 
-When you've successfully searched for your application, look for the `guid` value. It's a unique identifier for your application. You should copy it or write it down.
+If the account ID is valid, and the application name exists in your account, `apm application search` yields data similar to this example:
 
 ```json lineNumbers=false
 [
@@ -134,27 +146,31 @@ When you've successfully searched for your application, look for the `guid` valu
 ]
 ```
 
+When you've successfully searched for your application, look for the `guid` value. It's a unique identifier for your application. You should copy it or write it down.
+
 </Step><Step>
 
-## Add a simple tag to your application
+Add a simple tag to your application.
 
 Now that you have the GUID, you can point the New Relic CLI directly at your application. Adding a tag is the simplest way to try out the CLI capabilities (don't worry, tags can be deleted by using [`entity tags delete`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_entity_tags_delete.md)).
 
-Let's suppose that you want to add an environment tag to your application. Go ahead and add the `dev:testing` tag⁠ (or any other key-value pair) to your application using the [`entities tags create`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_entity_tags_create.md) command.
+Here, you add an environment tag to your application. Add the `dev:testing` tag⁠ (or any other key-value pair) to your application using the [`entities tags create`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_entity_tags_create.md) command:
 
 ```sh lineNumbers=false
 newrelic entity tags create --guid YOUR_APP_GUID --tag devkit:testing
 ```
 
 </Step><Step>
 
-What if you want to add multiple tags? Tag sets come to the rescue! While tags are key-value pairs separated by colons, tag sets are comma separated lists of tags. For example:
+Add tag sets.
+
+What if you want to add multiple tags? Tag sets to the rescue! While tags are key-value pairs separated by colons, tag sets are comma separated lists of tags. For example:
 
 ```txt copyable=false
 tag1:value1,tag2:value2
 ```
 
-To add multiple tags at once to your application, modify and run the following snippet.
+To add multiple tags to your application at once, modify and run this snippet:
 
 ```sh lineNumbers=false
 newrelic entity tags create --guid YOUR_APP_GUID --tag tag1:test,tag2:test
@@ -168,15 +184,17 @@ Adding tags is an asynchronous operation: this means it could take a while for t
 
 </Step><Step>
 
-You've created and added some tags to your application, but how do you know they're there? You need to retrieve your application's tags.
+Retrieve your application's tags.
+
+You've created and added some tags to your application, but to test that they're working, you need to retrieve them.
 
-To retrieve your application's tags, use the [`entity tags get`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_entity_tags_get.md) command.
+Run the [`entity tags get`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_entity_tags_get.md) command:
 
 ```sh
 newrelic entity tags get --guid YOUR_APP_GUID
 ```
 
-All tags associated with your application are retrieved as a JSON array.
+All tags associated with your application are retrieved as a JSON array:
 
 ```json lineNumbers=false
 [
@@ -198,21 +216,23 @@ All tags associated with your application are retrieved as a JSON array.
 
 </Step><Step>
 
-## Bonus step: Create a deployment marker
+Bonus step: create a deployment marker.
 
 Deployments of applications often go wrong. [Deployment markers](https://docs.newrelic.com/docs/apm/new-relic-apm/maintenance/record-monitor-deployments) are labels that, when attached to your application data, help you track deployments and troubleshoot what happened.
 
-To create a deployment marker, run the [`apm deployment create`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_apm_deployment_create.md) command using the same Application ID from your earlier search.
+To create a deployment marker, run the [`apm deployment create`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_apm_deployment_create.md) command using the same application ID from your earlier search:
 
 ```bash lineNumbers=false
 newrelic apm deployment create --applicationId YOUR_APP_ID --revision $(git describe --tags --always)
 ```
 
 </Step><Step>
 
-Notice that the JSON response includes the revision and timestamp of the deployment. This workflow could be built into a continuous integration or continuous deployment (CI/CD) system to help indicate changes in your application's behavior after deployments.
+Check the JSON response for the revision and timestamp of the deployment.
+
+You can build this workflow into a continuous integration or continuous deployment (CI/CD) system to indicate changes in your application's behavior after deployments.
 
-Here is an example.
+Here's an example:
 
 ```json lineNumbers=false
 {
@@ -230,6 +250,6 @@ Here is an example.
 
 ## Next steps
 
-Have a look at [all the available commands](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic.md). For example, you could create a [New Relic workflow](https://docs.newrelic.com/docs/new-relic-one/use-new-relic-one/core-concepts/new-relic-one-workloads-isolate-resolve-incidents-faster) using [`workload create`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_workload_create.md)
+Have a look at [all the available commands](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic.md) in the New Relic CLI. For example, you can create a [New Relic workflow](https://docs.newrelic.com/docs/new-relic-one/use-new-relic-one/core-concepts/new-relic-one-workloads-isolate-resolve-incidents-faster) using [`workload create`](https://github.com/newrelic/newrelic-cli/blob/master/docs/cli/newrelic_workload_create.md)
 
 If you'd like to engage with other community members, visit our [New Relic Explorers Hub](https://discuss.newrelic.com/c/build-on-new-relic/developer-toolkit) page. We welcome feature requests or bug reports on [GitHub](https://github.com/newrelic/newrelic-cli).

src/markdown-pages/build-apps/howto-use-nrone-table-components.mdx

@@ -71,7 +71,7 @@ export default class Nr1HowtoAddTimePicker extends React.Component {
 </Step>
 <Step>
 
-Run the demo application
+Run the demo application.
 
 Change the directory back to `nr1-how-to/create-a-table`. Before you can load the demo application, you need to [update its unique id](https://developer.newrelic.com/build-tools/new-relic-one-applications/guide-to-authentication--data-access--and-permissions) by invoking the New Relic One CLI.
 
@@ -131,7 +131,7 @@ import {
 </Step>
 <Step>
 
-Add a basic Table component
+Add a basic Table component.
 Locate the empty `GridItem` in `index.js`: This is where you start building the table.
 
 Add the initial `<Table>` component. The `items` property collects the data by calling `_getItems()`, which contains sample values.
@@ -145,11 +145,11 @@ Add the initial `<Table>` component. The `items` property collects the data by c
 </Step>
 <Step>
 
-Add the header and rows
+Add the header and rows.
 
 As the [`Table`](https://developer.newrelic.com/client-side-sdk/index.html#components/Table) component renders a fixed number of header cells and rows, your next step is adding header components, as well as a function that returns the required table rows.
 
-Inside of the `Table` component, add the `TableHeader` and then a `TableHeaderCell` child for each heading.
+Inside the `Table` component, add the `TableHeader` and then a `TableHeaderCell` child for each heading.
 
 Since you don't know how many rows you'll need, your best bet is to call a function to build as many `TableRows` as items returned by `_getItems()`.
 
@@ -184,7 +184,7 @@ Take a look at the application running in New Relic One: you should see somethin
 </Step>
 <Step>
 
-Replace standard table cells with smart cells
+Replace standard table cells with smart cells.
 
 The New Relic One library includes cell components that can automatically format certain data types, like users, metrics, and entity names.