Skip to content

Commit

Permalink
add contribution guide
Browse files Browse the repository at this point in the history
  • Loading branch information
themsaid committed Nov 8, 2018
1 parent a254c77 commit 425122f
Show file tree
Hide file tree
Showing 2 changed files with 44 additions and 0 deletions.
40 changes: 40 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Contributing

All contributions are welcomed. If it's your first time contributing to open source please don't hesitate and just open a Pull Request. Your suggestion/fix isn't stupid, I'll make sure I explain what's wrong with your PR if it wasn't accepted.

## Here are some points to consider:

- Your PR must be making only a single change, if you want to suggest multiple features or fix multiple issues please open separate PRs.
- If you have an idea that will require a lot of work, make sure you suggest it in a new [issue](https://github.com/writingink/wink/issues) first to make sure it's admired before investing time into it.
- If you want to contribute and not sure where to start, check the [road map](https://github.com/writingink/wink#road-map).
- Pull Requests that don't have a clear explanation of what it does will be closed. Sorry :)
- Keep your code clean. Clean means you're proud of how it turned out.

## How to contribute:

Clone wink on your machine, include it in your laravel application via composer using the Path Repository method:

Add this to your composer to JSON

```
"repositories": [
{
"type": "path",
"url": "./../wink"
}
],
```

And when you require wink, add it like:

```
"writingink/wink": "*@dev"
```

Run `composer update` in your laravel project, then `php artisan wink:install`, and then `php artisan wink:migrate`. Now you have wink running in your laravel project using the files on your machine.

Now head to the `wink` directory and run `yarn` to install the frontend dependencies.

If you make changes to Wink's frontend code, run `yarn run dev`.

Any change you apply should reflect on the test laravel application you setup earlier.
4 changes: 4 additions & 0 deletions readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,10 @@ And here are some ideas I'm still not sure about:
- [ ] Multi-lingual content


## Contributing

Check our [contribution guide](CONTRIBUTING.md).

## License

Wink is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

0 comments on commit 425122f

Please sign in to comment.