Update Account Management DOC-496

Author: pwseg

src/guides/intro-admin.md

@@ -7,9 +7,9 @@ If your job is to set up or maintain a Segment Workspace for your organization,
 ## What is Segment?
 
 > info ""
-> If you read the [detailed explanation of Segment](/docs/guides/) on the previous page, you can skip ahead!
+> If you've already read [an Introduction to Segment](/docs/guides/), you can skip ahead.
 
-Segment is a system for sending messages from your websites, mobile apps, and servers. These messages contain data about events on, or users of those systems, and these messages can sent on to other tools, and gathered together in a warehouse for later analysis. Segment can also bring in information about your users from external systems, such as helpdesks or CRM systems, and collate that information to help you analyze your data, build audiences of users, and personalize your users' experiences.
+Segment is a system for sending messages from your websites, mobile apps, and servers. These messages contain event and user data that you can send to other tools or collect in warehouses for further analysis. Segment also gathers information about your users from external systems, like helpdesks or CRMs. You can use this collated information to analyze data, build user audiences, and personalize your users' experiences.
 
 ## What's a Workspace?
 
@@ -20,23 +20,23 @@ Segment is a system for sending messages from your websites, mobile apps, and se
 
 You don't have to be a developer to be a Workspace administrator for an organization, and this guide only covers tasks specifically related to managing a Workspace in the [Segment App](/docs/segment-app/).
 
-However, many Workspace admins are also involved in the Segment implementation process as there are usually some tasks that must be performed in the Workspace to complete an implementation. If you think you might be developing a Segment implementation or helping out other developers, it's a good idea to [read the Segment developer intro](/docs/guides/intro-impl/)!
+However, many Workspace admins are also involved in the Segment implementation process as there are usually some tasks that must be performed in the Workspace to complete an implementation. If you think you might develop a Segment implementation or help out other developers, first read [Segment for developers](/docs/guides/intro-impl/).
 
 > note ""
 > **Note**: Workspace roles are only available to Business Tier customers. If you're on a Free or Team plan, all workspace members are granted workspace administrator access.
 
 In addition, Workspace administrators set up and maintain the organization's [workspace settings](https://app.segment.com/goto-my-workspace/settings/), which include:
 - Billing information and billing contacts
 - Incident contacts - the people who get notified in the event of an outage or incident
-- the Workspace name and slug - the display name and namespace of the workspace in the Segment system
+- The Workspace name and slug - the display name and namespace of the workspace in the Segment system
 
 > info ""
-> Changing the workspace name and slug do not have any effect on any sources or destinations already set up and configured. (These use a combination of an internal ID, and `writeKey` to connect.)
+> Changing a workspace name and slug won't impact configured sources or destinations, which connect using an internal ID and `writeKey`.
 
 Workspace administrators might also maintain:
 - **The organization's authentication settings**. This can include login settings, multi-factor authentication enforcement, Identity provider (IDP) settings (including SAML and OAuth), and other related settings.
 - **Access Management settings**. Business-tier plans include object-, group-, and role-based [access management settings](/docs/segment-app/iam/), Segment workspace "environments" and labels, roles and groups, and the general permissions model.
-- **Billing information**. If your Workspace is on a Team plan, you might have access to a billing page, where you can update the credit card on file, or change other billing details.
+- **Billing information**. If your Workspace is on a Team plan, you might have access to a billing page, where you can update the credit card on file or change other billing details.
 
 
 ## Tasks in Connections
@@ -45,19 +45,21 @@ As an administrator, you might be asked to help other members of your organizati
 
 ### Setting up destinations
 
-Destinations are the endpoint to which Segment sends data flowing from your Sources, and represent external tools (such as Google Analytics, Mixpanel, etc) and sometimes bulk-storage destinations like warehouses. You can set up a Destination from within the Segment App, by navigating to the [Destination Catalog](https://app.segment.com/goto-my-workspace/destinations/catalog) and selecting the tool you want to set up. In most cases, you'll need an existing API key or token, so Segment can send the data to the correct account. If you're setting up a Warehouse or other storage destination, more steps might be required, so see the [Warehouses documentation](/docs/connections/storage/warehouses/) for more details.
+Destinations are the endpoints to which Segment sends data flowing from your Sources. Destinations can be third-party external tools, like Google Analytics or Mixpanel, or bulk-storage resources, like warehouses.
+
+You can set up a Destination from within the Segment App by navigating to the [Destination Catalog](https://app.segment.com/goto-my-workspace/destinations/catalog) and selecting the tool you want to set up. In most cases, you'll need an existing API key or token so that Segment can send the data to the correct account. If you're setting up a Warehouse or other storage destination, more steps might be required; see the [Warehouses documentation](/docs/connections/storage/warehouses/) for more details.
 
 ### Troubleshooting
 
-Segment contains several ways to see what's going on in your Workspace:
+Use these Segment features to keep tabs on your Workspace:
 
 - **[Workspace Health](https://app.segment.com/goto-my-workspace/integration-health/)** - if there are any problems with sources or destinations in your workspace, they'll show up here.
-- **[Event Tester](/docs/connections/test-connections/)** - The Event tester allows you to troubleshoot both your Sources and their configuration, and the destiantions they send to. The Event Tester shows a sample of the data available, so you can check that it's being sent, and that it's in the correct format.
+- **[Event Tester](/docs/connections/test-connections/)** - The Event tester allows you to troubleshoot your Sources, their configuration, and their downstream destinations. The Event Tester shows a sample of the data available, so you can check that it's being sent, and that it's in the correct format.
 - **[Event Delivery](/docs/connections/event-delivery/)** - Event Delivery is a bit like the Event Tester, but specifically for determining if [rules or filters](/docs/guides/filtering-data/) within Segment are preventing data from getting to a destination.
-- Last but not least, check out our list of [integration error codes](/docs/connections/integration_error_codes/) for clues about what might be causing an error.
+- Check out Segment's list of [integration error codes](/docs/connections/integration_error_codes/) for insight into what might cause an error.
 
 > info ""
-> Still stumped? [Contact us](https://segment.com/help/contact/) for more help troubleshooting!
+> Still stumped? [Contact support](https://segment.com/help/contact/) for more help troubleshooting.
 
 
 <!-- TODO
@@ -70,4 +72,4 @@ protocols set up and maintenance
 Privacy monitoring
 -->
 > success ""
-> Have suggestions for things to add to this guide? [Drop us a line](mailto:[email protected]?subject=Segment%20Admin%20guide%20Suggestion)!
+> Have suggestions for this guide? [Reach out with your feedback](mailto:[email protected]?subject=Segment%20Admin%20guide%20Suggestion).

src/guides/usage-and-billing/account-management.md

@@ -4,41 +4,45 @@ title: Account Management
 
 ## What is the difference between an account and a workspace?
 
-An account is associated to a single user, and is attached to the email address you sign up with. A workspace houses all of your sources, and can have one or several user accounts as owners and/or read-only members.
+An account is associated to a single user and is attached to the email address you sign up with. A workspace houses all of your sources, and can have one or several user accounts as owners and/or read-only members.
 
 ## What if I change my domain name?
 
-You don't need to do anything if you change your domain – for example, if you change your domain from www.mysite.com to www.mysuperawesomesite.com. If you want the new domain to be used as the same Segment source, just make sure you use the same Segment write key that you used with the old domain.
+You don't need to do anything if you change your domain name. If the new domain name will serve as the same Segment source, make sure you use the same Segment write key that you used with the old domain.
 
-You may claim ownership of your domain for the purposes of Single Sign On login association, but it currently has no bearing on data collection.
+You may claim ownership of your domain for the purposes of single sign-on login association, but it currently has no bearing on data collection.
 
-## I'm on a Legacy API plan, why can't I add the integration I want?
+## I'm on a legacy API plan. Why can't I add the integration I want?
 
-Only users on our legacy API based plans will run into integration limits. Some of our older plans placed limitations on the integrations you could use. If you would like to add an integration that is not available on your current plan  move to a new Team plan where all integrations are included along with several other additional features.
+Some of Segment's previous plans, including the legacy API plan, limited integration usage. If you want to add an integration that's not available on your current plan, move to a new Team plan. Team plans include all integrations, along with other additional features.
 
 ## Will deleting my account cancel my subscription?
 
-No, deleting your account will only stop you from accessing workspaces through your login. The workspace is where the subscription is managed, and it will not be deleted. Data will still flow into Segment and your Destinations and you will still be charged if you delete your account but don't delete your workspace.
+No. Deleting your account only stops you from accessing workspaces through your login. The workspace is where the subscription is managed, and it will not be deleted. Data will still flow into Segment and your Destinations, and you will still be charged if you delete your account but don't delete your workspace.
 
 ## How do I delete my workspace entirely?
 
-To delete your workspace, go your [Workspace's Settings](https://app.segment.com/goto-my-workspace/settings/basic), click the "General" tab, and click **Delete Workspace**.
+To delete your workspace, go your [Workspace Settings](https://app.segment.com/goto-my-workspace/settings/basic), click the **General** tab, then click **Delete Workspace**.
 
 You should also change your write keys for each source and remove all Segment snippets from your codebase.
 
+## What happens if I change my workspace name or slug?
+
+Changing your workspace name or slug won't impact any sources or destinations you've already configured. If you're using [Segment's Config API](/docs/config-api/), though, you'll need to change the slug in your request URLs.
+
 ## Can I recover a source or workspace after I delete it?
 
-No, once a source or workspace is deleted it cannot be recovered.
+No. Deleted sources and workspaces cannot be recovered.
 
 ## Can I move a source from one workspace to another?
 
-Segment doesn't have the ability to "merge" workspaces, however you can achieve the same effect by moving your existing sources to a single workspace. You might do this to unify all of your data across your team(s) to better track your customer data as a complete picture.
+Though workspaces can't be merged, you can move an existing source to a single workspace to the same effect. For example, you might move existing sources to one workspace so that you can unify all of your data across teams and gain a broader view of your customer data tracking.
 
-You can move sources between workspaces going to the Settings for the source, clicking Transfer to Workspace in the left navigation. Choose the workspace you want to move the source to, and click **Transfer Source**.
+To move a source between workspaces, navigate to the source's **Settings** tab, then click **Transfer to Workspace**. Choose the workspace you're moving the source to, then click **Transfer Source**.
 
 > info ""
-> **Note**: The person who transfers the source must be a [workspace owner](/docs/segment-app/iam/) for both the origin and recipient workspaces, otherwise the recipient workspace won't appear in the dropdown list.
+> The person who transfers the source must be a [workspace owner](/docs/segment-app/iam/) for both the origin and recipient workspaces, otherwise the recipient workspace won't appear in the dropdown list.
 
-![](images/transfer-source.png)
+![Image of the Transfer to Workspace tab in Segment's platform](images/transfer-source.png "Transferring a source")
 
-When you transfer the source, all destination configurations are removed. Be sure to set up the destinations you want after the transfer.
+Transferring a source removes all associated destination configurations.  Be sure to set up the destinations you want after the transfer.