Skip to content

Commit 08bf2f2

Browse files
committed
fix readme for release v1
1 parent a33f887 commit 08bf2f2

File tree

1 file changed

+32
-2
lines changed

1 file changed

+32
-2
lines changed

README.md

Lines changed: 32 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,34 @@
11
# github-status-checks-enforce-naming-standard
2-
Makes sure, pull requests follow the naming standard (in this case lowercase files/folders)
2+
Makes sure the files updated with a pull requests follow the naming standard (in this case lowercase files/folders)
33

4-
Probably not especially usefull for anyone else, so public documentation is lacking.
4+
Probably not super usefull for anyone else.
5+
6+
There is a few options you can specify:
7+
| Input | Description | Required? | Default |
8+
|------------------------------|------------------------------------------------------|-----------|---------------|
9+
| require_lowercase_filenames | Whether all file names should be lowercase | Yes | true |
10+
| require_lowercase_foldername | Whether all folder names should be lowercase | Yes | true |
11+
| excluded_files | JSON list of filenames to exclude | No | ["README.md"] |
12+
| excluded_folders | JSON list of folders to exclude | No | [] |
13+
| github_token | The GITHUB_TOKEN to use for authenticating to github | No | N/A |
14+
15+
Please note, excluded_folders, should be the full path of the folder, as seen from the root of the repo, e.g Folder1/Subfolder without a trailing slash.
16+
17+
## Example status check Github Action workflow simple
18+
```yml
19+
name: Enforce naming standard
20+
21+
on: [pull_request]
22+
23+
jobs:
24+
enforce-naming-standard:
25+
runs-on: ubuntu-latest
26+
steps:
27+
- uses: mnj/github-status-checks-enforce-naming-standard@v1
28+
with:
29+
require_lowercase_filenames: 'true'
30+
require_lowercase_folders: 'true'
31+
excluded_files: '["README.md"]'
32+
excluded_folders: '[]'
33+
github_token: ${{ secrets.GITHUB_TOKEN }}
34+
```

0 commit comments

Comments
 (0)