mirror of
https://github.com/asdf-vm/asdf.git
synced 2024-11-15 01:28:17 -07:00
Add CONTRIBUTING.md.
This commit is contained in:
parent
0238b99148
commit
286c7eae92
39
CONTRIBUTING.md
Normal file
39
CONTRIBUTING.md
Normal file
@ -0,0 +1,39 @@
|
||||
# How to Contribute to asdf
|
||||
|
||||
## Did you find a bug?
|
||||
|
||||
**Ensure the bug is actually an issue with asdf and not a plugin.** If the bug
|
||||
only occurs when using one tool installed by asdf and not others it's likely an
|
||||
issue with the asdf plugin. Find the plugin repository on
|
||||
[asdf-vm/asdf-plugins](https://github.com/asdf-vm/asdf-plugins) and follow the
|
||||
plugin creators instructions for reporting the bug.
|
||||
|
||||
**Ensure the bug was not already reported** by searching on GitHub under
|
||||
[Issues](https://github.com/asdf-vm/asdf/issues).
|
||||
|
||||
If you are unable to find an open issue addressing the problem please [open
|
||||
a new one](https://github.com/asdf-vm/asdf/issues/new). Please be as specific
|
||||
as possible when reporting the issue. Include the observed behavior as well as
|
||||
what you thought should have happened. Please also provide environmental
|
||||
details like asdf version, shell, OS, etc...
|
||||
|
||||
## Did you write a patch that fixes a bug?
|
||||
|
||||
Open a new GitHub pull request with the patch. Refer to the [Development
|
||||
section of the README](https://github.com/asdf-vm/asdf#development) for the
|
||||
details on how to run the unit tests. Please make sure that unit tests pass on
|
||||
Travis CI.
|
||||
|
||||
## Did you create a plugin for asdf?
|
||||
|
||||
Please read the [creating plugins](doc/creating-plugins.md) guide.
|
||||
|
||||
## Do you want to contribute the asdf documentation?
|
||||
|
||||
Documentation can always be improved! Right now there is just the
|
||||
[README](README.md) and the [creating plugins](doc/creating-plugins.md) guide.
|
||||
The [wiki](https://github.com/asdf-vm/asdf/wiki) exists but is in a state of
|
||||
disrepair. If you see something that can be improved please submit a pull
|
||||
request or edit the wiki.
|
||||
|
||||
Thanks for contributing!
|
@ -204,6 +204,10 @@ and temporarily prepend the `bin` and `shims` directory of the directory to your
|
||||
We use [bats](https://github.com/sstephenson/bats) for testing,
|
||||
so make sure `bats test/` passes after you made your changes.
|
||||
|
||||
## Contributing
|
||||
|
||||
See [CONTRIBUTING.md](CONTRIBUTING.md) for the contribution guidelines.
|
||||
|
||||
## Credits
|
||||
|
||||
Me ([@HashNuke](https://github.com/HashNuke)), High-fever, cold, cough.
|
||||
|
Loading…
Reference in New Issue
Block a user