Docs: CI - link videos

2 files changed, 14 insertions, 12 deletions

diff --git a/doc/ci/ci_cd_for_external_repos/github_integration.md b/doc/ci/ci_cd_for_external_repos/github_integration.md
index 612dcc93bc1..2a8ddb610f9 100644
--- a/doc/ci/ci_cd_for_external_repos/github_integration.md
+++ b/doc/ci/ci_cd_for_external_repos/github_integration.md
@@ -5,24 +5,17 @@ type: howto
 # Using GitLab CI/CD with a GitHub repository **[PREMIUM]**
 
 GitLab CI/CD can be used with **GitHub.com** and **GitHub Enterprise** by
-creating a [CI/CD project](https://docs.gitlab.com/ee/user/project/ci_cd_for_external_repo.html) to connect your GitHub repository to
+creating a [CI/CD project](index.md) to connect your GitHub repository to
 GitLab.
 
-NOTE: **Note:**
-To use **GitHub Enterprise** with **GitLab.com** you should use the
-manual method.
+<i class="fa fa-youtube-play youtube" aria-hidden="true"></i>
+Watch a video on [Using GitLab CI/CD pipelines with GitHub repositories](https://www.youtube.com/watch?v=qgl3F2j-1cI).
 
 ## Connect with GitHub integration
 
 If the [GitHub integration](../../integration/github.md) has been enabled by your GitLab
 administrator:
 
-NOTE: **Note:**
-Due to a 10-token limitation on the [GitHub OAuth Implementation](https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps/#creating-multiple-tokens-for-oauth-apps),
-if you import more than 10 times, your oldest imported project's token will be
-revoked. See issue [#9147](https://gitlab.com/gitlab-org/gitlab-ee/issues/9147)
-for more information.
-
 1. In GitLab create a **CI/CD for external repo** project and select
    **GitHub**.
 
@@ -42,6 +35,12 @@ GitLab will:
 1. Enable [GitHub project integration](https://docs.gitlab.com/ee/user/project/integrations/github.html).
 1. Create a web hook on GitHub to notify GitLab of new commits.
 
+CAUTION: **Caution:**
+Due to a 10-token limitation on the [GitHub OAuth Implementation](https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps/#creating-multiple-tokens-for-oauth-apps),
+if you import more than 10 times, your oldest imported project's token will be
+revoked. See issue [#9147](https://gitlab.com/gitlab-org/gitlab-ee/issues/9147)
+for more information.
+
 ## Connect with Personal Access Token
 
 NOTE: **Note:**
@@ -79,6 +78,9 @@ GitLab will:
 
 ## Connect manually
 
+NOTE: **Note:**
+To use **GitHub Enterprise** with **GitLab.com** use this method.
+
 If the [GitHub integration](../../integration/github.md) is not enabled, or is enabled
 for a different GitHub instance, you GitLab CI/CD can be manually enabled for
 your repository:
diff --git a/doc/ci/ci_cd_for_external_repos/index.md b/doc/ci/ci_cd_for_external_repos/index.md
index 5de88412121..d46e451c609 100644
--- a/doc/ci/ci_cd_for_external_repos/index.md
+++ b/doc/ci/ci_cd_for_external_repos/index.md
@@ -4,12 +4,12 @@ type: index, howto
 
 # GitLab CI/CD for external repositories **[PREMIUM]**
 
+>[Introduced][ee-4642] in [GitLab Premium][eep] 10.6.
+
 NOTE: **Note:**
 This feature [is available for free](https://about.gitlab.com/2019/03/21/six-more-months-ci-cd-github/) to
 GitLab.com users until September 22nd, 2019.
 
->[Introduced][ee-4642] in [GitLab Premium][eep] 10.6.
-
 GitLab CI/CD can be used with:
 
 - [GitHub](github_integration.md).