Initial commit

README.md

@@ -0,0 +1,50 @@
+# Pull Request Labeller
+
+This action labels pull requests by comparing their changed files to a configuration file in the repository.
+
+For example, a configuration file at `.github/triage.yml` may look like this:
+
+```yaml
+design:
+  - src/frontend/**/*.css
+  - src/frontend/**/*.png
+
+server:
+  - src/server/**/*
+```
+
+And the action would be used like this:
+
+```workflow
+workflow "Apply PR labels" {
+  on = "pull_request"
+  resolves = "Apply labels"
+}
+
+action "On sync" {
+  uses = "actions/bin/filter@master"
+  args = "action synchronize"
+}
+
+action "Apply labels" {
+  uses = "actions/labeller@v1.0.0"
+  needs = "On sync"
+  env = {LABEL_SPEC_FILE=".github/triage.yml"}
+  secrets = ["GITHUB_TOKEN"]
+}
+```
+
+Now, whenever a user pushes to a pull request, this action will determine whether any changed files in that pull request match the specification file (note: this action uses [minimatch](https://github.com/isaacs/minimatch) to determine matches). If there are matches, the action will apply the appropriate labels to the pull request.
+
+## Contributing
+
+Check out [this doc](CONTRIBUTING.md).
+
+## License
+
+This action is released under the [MIT license](LICENSE.md).
+Container images built with this project include third party materials. See [THIRD_PARTY_NOTICE.md](THIRD_PARTY_NOTICE.md) for details.
+
+## Current Status
+
+This action is in active development.