Skip to content

Commit 8d6e215

Browse files
authored
EDI-ify "Using pre-written building blocks in your workflow" (#56783)
1 parent 7eae77a commit 8d6e215

File tree

2 files changed

+12
-29
lines changed

2 files changed

+12
-29
lines changed

content/actions/get-started/understanding-github-actions.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,11 @@ For more information, see [AUTOTITLE](/actions/using-jobs).
7878

7979
### Actions
8080

81-
An **action** is a custom application for the {% data variables.product.prodname_actions %} platform that performs a complex but frequently repeated task. Use an action to help reduce the amount of repetitive code that you write in your **workflow** files. An action can pull your Git repository from {% data variables.product.prodname_dotcom %}, set up the correct toolchain for your build environment, or set up the authentication to your cloud provider.
81+
An **action** is a pre-defined, reusable set of jobs or code that performs specific tasks within a **workflow**, reducing the amount of repetitive code you write in your workflow files. Actions can perform tasks such as:
82+
83+
* Pulling your Git repository from {% data variables.product.prodname_dotcom %}
84+
* Setting up the correct toolchain for your build environment
85+
* Setting up authentication to your cloud provider
8286

8387
You can write your own actions, or you can find actions to use in your workflows in the {% data variables.product.prodname_marketplace %}.
8488

content/actions/how-tos/writing-workflows/choosing-what-your-workflow-does/using-pre-written-building-blocks-in-your-workflow.md

Lines changed: 7 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Using pre-written building blocks in your workflow
33
shortTitle: Find and customize actions
4-
intro: 'Actions are the building blocks that power your workflow. A workflow can contain actions created by the community, or you can create your own actions directly within your application''s repository. This guide will show you how to discover, use, and customize actions.'
4+
intro: 'You can use and customize pre-written actions to power your workflow.'
55
redirect_from:
66
- /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions
77
- /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow
@@ -19,28 +19,6 @@ topics:
1919
- Fundamentals
2020
---
2121

22-
{% data reusables.actions.enterprise-github-hosted-runners %}
23-
24-
## Overview
25-
26-
You can use pre-written building blocks, called actions, in your workflow. An action is a pre-defined, reusable set of jobs or code that perform specific tasks within a workflow.
27-
28-
Actions can be:
29-
30-
* **Reusable:** actions can be used across different workflows and repositories, allowing you to avoid rewriting the same code.
31-
* **Pre-written:** many actions are available in the {% data variables.product.prodname_marketplace %}, covering a wide range of tasks like checking out code, setting up environments, running tests, and deploying applications.
32-
* **Configurable:** you can configure actions with inputs, outputs, and environment variables to tailor them to your specific needs.
33-
* **Community-driven:** you can create your own actions and share them with others or use actions developed by the community.
34-
35-
The actions you use in your workflow can be defined in:
36-
37-
* The same repository as your workflow file{% ifversion ghec or ghes %}
38-
* An internal repository within the same enterprise account that is configured to allow access to workflows{% endif %}
39-
* Any public repository
40-
* A published Docker container image on Docker Hub
41-
42-
{% data variables.product.prodname_marketplace %} is a central location for you to find actions created by the {% data variables.product.prodname_dotcom %} community.{% ifversion fpt or ghec %} [{% data variables.product.prodname_marketplace %} page](https://github.com/marketplace/actions/) enables you to filter for actions by category. {% endif %}
43-
4422
{% data reusables.actions.enterprise-marketplace-actions %}
4523

4624
{% data reusables.actions.actions-marketplace-ghecom %}
@@ -59,7 +37,12 @@ You can search and browse actions directly in your repository's workflow editor.
5937

6038
## Adding an action to your workflow
6139

62-
You can add an action to your workflow by referencing the action in your workflow file.
40+
You can add an action to your workflow by referencing the action in your workflow file. The actions you use in your workflow can be defined in:
41+
42+
* The same repository as your workflow file{% ifversion ghec or ghes %}
43+
* An internal repository within the same enterprise account that is configured to allow access to workflows{% endif %}
44+
* Any public repository
45+
* A published Docker container image on Docker Hub
6346

6447
You can view the actions referenced in your {% data variables.product.prodname_actions %} workflows as dependencies in the dependency graph of the repository containing your workflows. For more information, see “[About the dependency graph](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph).”
6548

@@ -182,7 +165,3 @@ outputs:
182165
results-file: # id of output
183166
description: "Path to results file"
184167
```
185-
186-
## Next steps
187-
188-
To continue learning about {% data variables.product.prodname_actions %}, see [AUTOTITLE](/actions/learn-github-actions/essential-features-of-github-actions).

0 commit comments

Comments
 (0)