From 8ceba1eea064bf2c37bd2b76d250b0ebed116da6 Mon Sep 17 00:00:00 2001
From: Arjun Attam <arjunattam@gmail.com>
Date: Fri, 24 Apr 2020 12:19:54 -0700
Subject: [PATCH] docs(ci): update ci docs to emphasize gh action (#1964)

---
 docs/ci.md | 26 +++++++++++++++++---------
 1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/docs/ci.md b/docs/ci.md
index 6c2ec77828..9e8634a3a9 100644
--- a/docs/ci.md
+++ b/docs/ci.md
@@ -1,27 +1,35 @@
-# Continuous integration
+# Continuous Integration
 
 Playwright tests can be executed to run on your CI environments. To simplify this, we have created sample configurations for common CI providers that can be used to bootstrap your setup.
 
-#### Contents
-- [Docker](#docker)
+<!-- GEN:toc -->
 - [GitHub Actions](#github-actions)
+- [Docker](#docker)
 - [Azure Pipelines](#azure-pipelines)
 - [Travis CI](#travis-ci)
 - [CircleCI](#circleci)
 - [AppVeyor](#appveyor)
+<!-- GEN:stop -->
 
 Broadly, configuration on CI involves **ensuring system dependencies** are in place, **installing Playwright and browsers** (typically with `npm install`), and **running tests** (typically with `npm test`). Windows and macOS build agents do not require any additional system dependencies. Linux build agents can require additional dependencies, depending on the Linux distribution.
 
-<br/>
+## GitHub Actions
+
+The [Playwright GitHub Action](https://github.com/microsoft/playwright-github-action) can be used to run Playwright tests on GitHub Actions.
+
+```yml
+steps:
+  - uses: microsoft/playwright-github-action@v1
+  - name: Run your tests
+    run: npm test
+```
+
+We run [our tests](/.github/workflows/tests.yml) on GitHub Actions, across a matrix of 3 platforms (Windows, Linux, macOS) and 3 browsers (Chromium, Firefox, WebKit).
 
 ## Docker
 
 We have a [pre-built Docker image](docker/README.md) which can either be used directly, or as a reference to update your existing Docker definitions.
 
-## GitHub Actions
-
-We run [our tests](/.github/workflows/tests.yml) on GitHub Actions, across a matrix of 3 platforms (Windows, Linux, macOS) and 3 browsers (Chromium, Firefox, WebKit). Use the [microsoft/playwright-github-action](https://github.com/microsoft/playwright-github-action) to bootstrap your GitHub Actions configuration.
-
 ## Azure Pipelines
 
 For Windows or macOS agents, no additional configuration required, just install Playwright and run your tests.
@@ -38,4 +46,4 @@ We run our tests on CircleCI, with our [pre-built Docker image](docker/README.md
 
 ## AppVeyor
 
-We run our tests on Windows agents in AppVeyor. Use our [AppVeyor configuration](/.appveyor.yml) to create your own.
+We run our tests on Windows agents in AppVeyor. Use our [AppVeyor configuration](/.appveyor.yml) to create your own.
\ No newline at end of file