Merge branch 'main' into joshmgross/error-experience

Author: joshmgross

README.md

@@ -1,57 +1,44 @@
 # GitHub Actions for VS Code
 
-[![Build](https://github.com/github/vscode-github-actions/actions/workflows/build.yml/badge.svg)](https://github.com/github/vscode-github-actions/actions/workflows/build.yml)
+The GitHub Actions extension lets you manage you manage your workflows, view the workflow run history, and helps with authoring workflows.
 
-Simple extension to interact with GitHub Actions from within VS Code.
-
-## Setup
-
-1. Install the extension from the [Marketplace](https://marketplace.visualstudio.com/items?itemName=github.vscode-github-actions)
-2. Open a repository with a `github.com` `origin` git remote
-3. When prompted, allow `GitHub Actions` access to your GitHub account:
-
-    ![Sign in via Accounts menu](./media/allow-access.png)
+![](./media/header.png)
 
 ## Features
 
-The extension provides a convenient way to monitor workflows and workflow runs from VS Code as well as language-server features for editing workflow YAML files.
-
-### Auto-complete and documentation
+### Manage workflows and runs
 
-No additional YAML extension needed, this extension includes a built-in language server with support for the workflow schema:
+* Manage your workflows and runs without leaving your editor.
+* Keep track of your CI builds and deployments.
+* Investigate failures and view logs.
 
-![Workflow auto-complete](./media/workflow-auto-complete.gif)
+![View workflow runs and logs](./media/workflows.png)
 
-Auto-completion and validation for every action you reference in `uses`:
+### Workflow authoring
 
-![Actions auto-complete](./media/actions-auto-complete.gif)
+Be more confident when authoring and modifying workflows. Find errors before committing workflows with:
 
-Auto-completion and validation of labels for hosted and self-hosted runners:
+**Syntax highlighting** for workflows and GitHub Actions Expressions makes it clear where values are inserted at execution time:
 
-![Auto-complete runner label](./media/runs-on-auto-complete.gif)
+![Syntax highlighting](media/highlight.png)
 
-#### Expressions auto-complete
+**Integrated documentation** for the workflow schema, expression functions, and even event payloads:
 
-Auto-completion, validation, and evaluation of expressions:
+![Tooltip showing description for a pull_request payload](media/docs.png)
 
-![Auto-complete and evaluation of expressions](./media/env-auto-complete.gif)
+**Validation and code completion** for the YAML schema and GitHub Actions Expressions. Get instant validation and code completion for the workflow schema, expression functions, event payloads, and job or step `outputs`:
 
-Auto-complete and validate all webhook event payloads:
+![Validation for YAML keys and expressions](media/validation.png)
 
-![Auto-complete github event expressions](./media/github-auto-complete.gif)
+**Smart validation and code completion for actions and reusable workflows**: the extension automatically parses parameters, inputs, and outputs for referenced actions and called reusable workflows for code-completion and validation.
 
-### Monitor workflow runs
+![Video showing workflow validation and auto-completion](./media/authoring.gif)
 
-See runs for workflows in the repository, drill into jobs and steps, and inspect logs:
+## Getting started
 
-![See workflows and runs for the current repository](./media/logs.gif)
-
-
-### Other features
-
-- Trigger `repository_dispatch` or `workflow_dispatch` workflow runs
-- View, edit, and add secrets
-- Pin workflow to the VS Code status bar
+1. Install the extension from the [Marketplace](https://marketplace.visualstudio.com/items?itemName=github.vscode-github-actions)
+1. Sign in with your GitHub account and when prompted allow `GitHub Actions` access to your GitHub account.
+1. Open a GitHub repository
 
 ## Contributing