auth/vendor/github.com/fsnotify/fsnotify/CONTRIBUTING.md

27 lines
1013 B
Markdown
Raw Normal View History

2023-01-16 01:55:01 +00:00
Thank you for your interest in contributing to fsnotify! We try to review and
merge PRs in a reasonable timeframe, but please be aware that:
2022-06-09 17:35:23 +00:00
2023-01-16 01:55:01 +00:00
- To avoid "wasted" work, please discus changes on the issue tracker first. You
can just send PRs, but they may end up being rejected for one reason or the
other.
2022-06-09 17:35:23 +00:00
2023-01-16 01:55:01 +00:00
- fsnotify is a cross-platform library, and changes must work reasonably well on
all supported platforms.
2022-06-09 17:35:23 +00:00
2023-01-16 01:55:01 +00:00
- Changes will need to be compatible; old code should still compile, and the
runtime behaviour can't change in ways that are likely to lead to problems for
users.
2022-06-09 17:35:23 +00:00
2023-01-16 01:55:01 +00:00
Testing
-------
Just `go test ./...` runs all the tests; the CI runs this on all supported
platforms. Testing different platforms locally can be done with something like
[goon] or [Vagrant], but this isn't super-easy to set up at the moment.
2022-06-09 17:35:23 +00:00
2023-01-16 01:55:01 +00:00
Use the `-short` flag to make the "stress test" run faster.
2022-06-09 17:35:23 +00:00
2023-01-16 01:55:01 +00:00
[goon]: https://github.com/arp242/goon
[Vagrant]: https://www.vagrantup.com/
[integration_test.go]: /integration_test.go