Skip to content

Commit 77c5b41

Browse files
jackton1ZPascal
andauthored
docs: improve documentation and update image (#195)
docs: Adjust the Token handling documentation Co-authored-by: Pascal Zimmermann <[email protected]> --------- Co-authored-by: Pascal Zimmermann <[email protected]>
1 parent f17d07c commit 77c5b41

File tree

4 files changed

+10
-11
lines changed

4 files changed

+10
-11
lines changed

README.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
# GitHub Action for GitHub Push
22

3-
The GitHub Actions for pushing to GitHub repository local changes authorizing using GitHub token.
3+
The GitHub Actions for pushing local changes to GitHub using an authorized GitHub token.
44

5-
With ease:
5+
## Use Cases
66

7-
- update new code placed in the repository, e.g. by running a linter on it,
8-
- track changes in script results using Git as archive,
7+
- update new code placed in your repository, e.g. by running a linter on it,
8+
- track changes in script results using Git as an archive,
99
- publish page using GitHub-Pages,
1010
- mirror changes to a separate repository.
1111

@@ -19,21 +19,20 @@ Follow these steps to set up the necessary permissions:
1919
3. In the left sidebar, click on `Actions`.
2020
4. Under the `Actions` settings, find and click on `General`.
2121
5. Scroll down to the `Workflow permissions` section.
22-
6. You will see the default permission setting for the `GITHUB_TOKEN`. Click on the option for `Read and write permissions`.
23-
7. With this setting, your workflow will have the ability to read the contents of the repository and push back changes, which is required for using this GitHub Action.
22+
6. You will see the default permission setting for the `GITHUB_TOKEN`. Click on the `Read and write permissions` option.
23+
7. With this setting, your workflow will be able to read the repository's contents and push back changes, which is required for using this GitHub Action.
2424

2525
Make sure to save your changes before exiting the settings page.
2626

2727
> [!NOTE]
2828
>
29-
> Granting `Read and write permissions` allows workflows to modify your repository, which can include adding or updating files and code. Always ensure that you trust the workflows you enable with these permissions.
30-
29+
> Granting `Read and write permissions` allows workflows to modify your repository, including adding or updating files and code. Always ensure that you trust the workflows you enable with these permissions.
3130
32-
![General Settings](docs/images/Github_Initial_Git_Push_Settings_General.png)
31+
![Settings-Workflow Permissions](docs/images/Github_Settings_Workflow_Permissions.jpeg)
3332

34-
![Workflow Settings](docs/images/Github_Initial_Git_Push_Settings_Actions.png)
33+
The `GITHUB_TOKEN` permissions can also be configured globally for all jobs in a workflow or individually for each job.
3534

36-
The `GITHUB_TOKEN` permissions can also be configured globally for all jobs in a workflow or individually for each job. This example demonstrates how to set the necessary permissions for the `contents` and `pull-requests` scopes on a job level:
35+
This example demonstrates how to set the necessary permissions for the `contents` and `pull-requests` scopes on a job level:
3736

3837
```yaml
3938
jobs:
-119 KB
Binary file not shown.
-55.4 KB
Binary file not shown.
270 KB
Loading

0 commit comments

Comments
 (0)