Skip to content

Commit 11b5219

Browse files
committed
Line edits
1 parent c56f7cd commit 11b5219

File tree

5 files changed

+22
-22
lines changed

5 files changed

+22
-22
lines changed

learn-pr/github/create-custom-github-actions/includes/create-custom-github-action.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -83,8 +83,8 @@ As you learned previously, your action needs to have a `runs` statement that def
8383

8484
Docker container actions require the `runs` statement to configure the image the Docker action uses with the following arguments:
8585

86-
- `using`: Needs to be set to `docker` to run a Docker container action
87-
- `image`: Docker image used as the container to run the action
86+
- `using`: Needs to be set to `docker` to run a Docker container action.
87+
- `image`: Docker image used as the container to run the action.
8888

8989
```yml
9090
runs:
@@ -96,8 +96,8 @@ runs:
9696

9797
JavaScript actions require that the `runs` statement take the following two arguments:
9898

99-
- `using`: Application used to execute the code as defined in `main`
100-
- `main`: File that contains the action code; the application defined in `using` executes this file
99+
- `using`: Application used to execute the code as defined in `main`.
100+
- `main`: File that contains the action code; the application defined in `using` executes this file.
101101

102102
For example, here's a `runs` statement for a JavaScript action using Node.js:
103103

@@ -111,9 +111,9 @@ runs:
111111

112112
Composite run steps actions require that the `runs` statement take the following three arguments:
113113

114-
- `using`: Needs to be set to `"composite"` to run a composite run step
115-
- `steps`: Run steps to run the action
116-
- `steps[*].run`: Command you want to run (can be inline or a script in your action repository)
114+
- `using`: Needs to be set to `"composite"` to run a composite run step.
115+
- `steps`: Run steps to run the action.
116+
- `steps[*].run`: Command you want to run (can be inline or a script in your action repository).
117117

118118
For example, here's a `runs` statement for a composite run steps action that will run the script at filepath `/test/script/sh`:
119119

learn-pr/github/create-custom-github-actions/includes/exercise-create-custom-action.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,9 @@ When you select the _Start the exercise on GitHub_ button, you'll navigate to a
1313
When you've finished the exercise in GitHub, return here for:
1414

1515
> [!div class="checklist"]
16-
> * A quick knowledge check
17-
> * A summary of what you've learned
18-
> * To earn a badge for completing this module
16+
> - A quick knowledge check
17+
> - A summary of what you've learned
18+
> - To earn a badge for completing this module
1919
2020
>[!NOTE]
2121
> You don't need to modify any of the workflow files to complete this exercise. **Altering the contents in this workflow can break the exercise's ability to validate your actions, provide feedback, or grade the results**.

learn-pr/github/create-custom-github-actions/includes/introduction.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
GitHub Actions allow you to create individual, custom actions by writing code that interacts with your repository in any way you'd like, including integrating with GitHub's APIs and any publicly available third-party API. For example, an action can publish npm modules, send SMS alerts when urgent issues are created, or deploy production-ready code.
22

3-
You can write your own custom actions to use in your workflow or share the actions you build with the GitHub community. To share actions you've built with the community, your repository must be public. Actions can run directly on compute resources (such as virtual machines) or in Docker containers. You can also define an action's inputs, outputs, and environment variables.
3+
You can write your own custom actions to use in your workflow, or share the actions you build with the GitHub community. To share actions you've built with the community, your repository must be public. Actions can run directly on compute resources (such as virtual machines) or in Docker containers. You can also define an action's inputs, outputs, and environment variables.
44

55
In this module, you'll learn the different ways to create a custom action, its necessary metadata and syntax, and how to publish a custom action to the GitHub Marketplace.
66

@@ -22,6 +22,6 @@ This module assumes you have basic familiarity with GitHub Actions and workflows
2222
- The ability to navigate and edit files in GitHub
2323
- For more information about GitHub, see [Introduction to GitHub](https://github.com/skills/introduction-to-github).
2424
- Basic familiarity with GitHub Actions and workflows
25-
- If you aren't familiar with workflows, jobs and steps, check out the [Automate development tasks by using GitHub Actions](/training/modules/github-actions-automate-tasks/) module
25+
- If you aren't familiar with workflows, jobs and steps, check out the [Automate development tasks by using GitHub Actions](/training/modules/github-actions-automate-tasks/) module.
2626
- Basic familiarity with continuous integration using GitHub Actions and workflows
27-
- If you're unfamiliar with continuous integration using GitHub Actions and workflows, check out [Build continuous integration workflows by using GitHub Actions](/training/modules/github-actions-ci/)
27+
- If you're unfamiliar with continuous integration using GitHub Actions and workflows, check out [Build continuous integration (CI) workflows by using GitHub Actions](/training/modules/github-actions-ci/).

learn-pr/github/create-custom-github-actions/includes/publish-custom-github-action.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -16,16 +16,16 @@ When an action is in a private repository, only workflows in the same repository
1616

1717
## Document your action
1818

19-
It can be very frustrating to use a new tool or application when the documentation is vague or even missing. It's important to include good documentation with your action so that others can see how it works, whether you plan to make it public or private. The first thing to do is creating a good `README.md` file for your action.
19+
It can be very frustrating to use a new tool or application when the documentation is vague or even missing. It's important to include good documentation with your action so that others can see how it works, whether you plan to make it public or private. The first thing to do is create a good `README.md` file for your action.
2020

2121
The `README.md` file is often the first place developers will look at to see how the action works. This is a great place to include all of the important information for the action. The following is a non-exhaustive list of things to include:
2222

23-
- A detailed description of what the action does
24-
- Required input and output arguments
25-
- Optional input and output arguments
26-
- Secrets the action uses
27-
- Environment variables the action uses
28-
- An example of how to use your action in a workflow
23+
- A detailed description of what the action does.
24+
- Required input and output arguments.
25+
- Optional input and output arguments.
26+
- Secrets the action uses.
27+
- Environment variables the action uses.
28+
- An example of how to use your action in a workflow.
2929

3030
As a general rule, the `README.md` file should include everything a user should know to use the action. If you think it could be useful information, include it in the `README.md`.
3131

@@ -35,7 +35,7 @@ If you're developing an action for other people to use, whether it's public or p
3535

3636
### Good practices for release and version management
3737

38-
A good release-management strategy should include versioning recommendations. Users should not be referencing an action's default branch with the action, because the default branch which is likely to contain the latest code (which might or might not be stable) and could result in your workflow breaking. Instead, we recommend that users specify a major version when using the action, and to only direct them to a more specific version if they encounter issues. They can do this by configuring their GitHub Actions workflow to target a tag, a commit's SHA, or a specific branch named for a release. Let's take a closer look at these release options.
38+
A good release-management strategy should include versioning recommendations. Users should not be referencing an action's default branch with the action. This is because the default branch that's likely to contain the latest code (which might or might not be stable) could result in your workflow breaking. Instead, we recommend that users specify a major version when using the action, and to only direct them to a more specific version if they encounter issues. They can do this by configuring their GitHub Actions workflow to target a tag, a commit's SHA, or a specific branch named for a release. Let's take a closer look at these release options.
3939

4040
#### Tags
4141

learn-pr/github/create-custom-github-actions/includes/summary.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Your goal in this module was to understand the different types of GitHub actions and then create your own custom GitHub action and use it in a workflow.
1+
Your goal in this module was to understand the different types of GitHub actions, and then create your own custom GitHub action and use it in a workflow.
22

33
To accomplish this goal, you first learned about the necessary metadata and syntax to write custom GitHub actions. You learned about workflow commands to extend functionality to your action, how to choose a private or public location for your action, and establishing best practices for documenting and versioning your action. You also learned how to publish your action to the GitHub Marketplace.
44

0 commit comments

Comments
 (0)