addressed comments and vale suggestions

stayseesong · stayseesong · commit 43b30a4d4e1a · 2021-06-09T10:17:59.000-07:00
diff --git a/src/connections/sources/catalog/libraries/website/plugins/vimeo/index.md b/src/connections/sources/catalog/libraries/website/plugins/vimeo/index.md
@@ -3,21 +3,21 @@ title: analytics.js Vimeo Plugin
 hidden: true
 ---
 
-With the analytics.js Vimeo Plugin you can easily collect Vimeo player events into the Segment ecosystem.
+With the analytics.js Vimeo Plugin you can collect Vimeo player events into the Segment ecosystem.
 
 ## Getting Started
 To use the Vimeo plugin:
 
-1. Generate an access token in Vimeo. The plugin uses this token to access metadata about the video content being played. Vimeo provides documentation to generate the access token [here](https://developer.vimeo.com/api/guides/start#generate-access-token).
-- **Note:** Make sure to carefully select your access scopes. The plugin only needs to read information about your video(s).
+1. Generate an access token in Vimeo. The plugin uses this token to access metadata about the playing video content. Vimeo provides documentation to [generate the access token](https://developer.vimeo.com/api/guides/start#generate-access-token).
+- **Note:** Make sure to select the access scopes you need as the plugin only needs to read information about your video(s).
 
 2. Enable a new plugin by navigating to the settings for your Source and clicking **Plugins**. You can enable the Vimeo plugin from this menu:
 
     ![the plugins setting screen](./images/youtube-vimeo-plugins-beta-2021-06-04.png)
 
 3. Initialize the plugin by entering your Vimeo access token and granting it access to the Vimeo video player instance(s) running on the page. Use this initialize method:
 
-```
+```js
 <iframe src="https://player.vimeo.com/video/76979871" width="640" height="360" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
 <script src="https://player.vimeo.com/api/player.js"></script>
 <script>
@@ -30,17 +30,17 @@ To use the Vimeo plugin:
     })
 </script>
 ```
-That's it! The plugin listens to the Vimeo player for events, and responds by firing the corresponding [Segment Video Spec](https://segment.com/docs/connections/spec/video/) events on Analytics.js.
+That's it! The plugin listens to the Vimeo player for events, and responds by firing the corresponding [Segment Video Spec](/docs/connections/spec/video/) events on Analytics.js.
 
 ## Supported Events
-The following [Segment Video Spec](https://segment.com/docs/connections/spec/video/) events are tracked by this plugin:
+The plugin tracks the following [Segment Video Spec](/docs/connections/spec/video/) events:
 - Video Playback Started
 - Video Playback Completed
 - Video Playback Paused/Resumed
 - Video Content Started/Completed
 
 ## Supported Properties
-The following [Segment Video Spec](https://segment.com/docs/connections/spec/video/) properties are automatically attached to the above events:
+The plugin automatically attaches the following [Segment Video Spec](/docs/connections/spec/video/) properties to the above events:
 
 **'Playback' Events**
 - Total Length
diff --git a/src/connections/sources/catalog/libraries/website/plugins/youtube/index.md b/src/connections/sources/catalog/libraries/website/plugins/youtube/index.md
@@ -3,28 +3,28 @@ title: analytics.js YouTube Plugin
 hidden: true
 ---
 
-With the analytics.js YouTube Plugin you can easily collect YouTube player events into the Segment ecosystem.
+With the analytics.js YouTube Plugin you can collect YouTube player events into the Segment ecosystem.
 
 ## Prerequisites
 The Segment YouTube Plugin requires the YouTube player JavaScript object as an input, so your YouTube player embed must use the [YouTube IFrame player API](https://developers.google.com/youtube/iframe_api_reference#Getting_Started).
 
-To begin, generate an API Key for the Segment YouTube plugin, which it uses to access metadata about the video content being played. To do this, create a new project in the Google Developer Console, then create a new API Key in that project for the Segment YouTube plugin. You can read more about this process in the YouTube documentation on [registering an application](https://developers.google.com/youtube/registering_an_application).
+To begin, generate an API Key for the Segment YouTube plugin, which it uses to access metadata about the playing video content. To do this, create a new project in the Google Developer Console, then create a new API Key in that project for the Segment YouTube plugin. You can read more about this process in the YouTube documentation on [registering an application](https://developers.google.com/youtube/registering_an_application).
 
 ## Getting Started
 
 After you've generated the API key:
 
 1. Enable a new plugin.
-- Navigate to **Connections > Sources** and choose the right source you want to connect your Youtube plugin to. Go to the **Settings** tab of your source and select **Plugins**. You can enable the YouTube plugin from this menu:
+- Navigate to **Connections > Sources** and choose the source you want to connect the YouTube plugin to. Go to the **Settings** tab of your source and select **Plugins**. You can enable the YouTube plugin from this menu:
 
     ![the plugins setting screen](./images/youtube-vimeo-plugins-beta-2021-06-04.png)
 
-    **Note:** At this time, only Javascript sources support plugins.
+    **Note:** Only Javascript sources support plugins.
 
 2. Initialize the plugin by giving it access to the YouTube video player instance(s) running on your page.
 - Use the initialize method in the YouTube `onYouTubeIframeAPIReady()` function to register and initialize the plugin with the player instance and your API key:
 
-```
+```js
 var player;
       function onYouTubeIframeAPIReady() {
               player = new YT.Player('player', {
@@ -38,22 +38,22 @@ var player;
       })}
 ```
 
-That's it! The plugin listens to the YouTube player for events, and fires the corresponding [Segment Video Spec](https://segment.com/docs/connections/spec/video/) events on analytics.js.
+That's it! The plugin listens to the YouTube player for events, and fires the corresponding [Segment Video Spec](/docs/connections/spec/video/) events on analytics.js.
 
 ## Supported Events
-The following [Segment Video Spec](https://segment.com/docs/connections/spec/video/) events are tracked by this plugin:
+The plugin tracks the following [Segment Video Spec](/docs/connections/spec/video/) events:
 
 Event | Details
 ----- | -------
-Video Playback Started | When a user presses Play; after the last user action required for playback to begin (eg, after user login/authentication). <br><br> - If playing a single video, this fires when the video starts. <br> - If playing a playlist, this fires when the first video in the playlist starts.
-Video Playback Completed | When playback is complete and only when the session is finished. <br><br>- If playing a single video, this fires when the video finishes. <br>- If playing a playlist, this event fires when the final video in the playlist finishes.
-Video Playback Paused/Resumed | When playback is resumed, by the user, after being paused.
+Video Playback Started | When a user presses Play; after the last user action required for playback to begin. For example, after user login/authentication. <br><br> - If playing a single video, this fires when the video starts. <br> - If playing a playlist, this fires when the first video in the playlist starts.
+Video Playback Completed | When playback is complete and when the session finishes. <br><br>- If playing a single video, this fires when the video finishes. <br>- If playing a playlist, this event fires when the final video in the playlist finishes.
+Video Playback Paused/Resumed | When the user resumes playback after pausing.
 Video Playback Buffer Started/Completed | When playback starts and finishes buffering content or an ad.
 Video Playback Seek Started/Completed | When a user manually seeks a certain position of the content or ad in the playback.
 Video Content Started/Completed | When a video content segment starts and completes playing within a playback. <br><br>- If playing a playlist, these events get fired for each individual video.
 
 ## Supported Properties
-The following [Segment Video Spec](https://segment.com/docs/connections/spec/video/) properties are automatically attached to the above events:
+The plugin automatically attaches the following [Segment Video Spec](/docs/connections/spec/video/) to the above events:
 
 **'Playback' Events**
 - Total Length
