Skip to content

Commit

Permalink
Merge pull request #63 from configcat/contributing
Browse files Browse the repository at this point in the history
contributing
kp-cat authored May 9, 2021
2 parents 2b4b763 + f3d2eec commit b59a33c
Showing 3 changed files with 80 additions and 1 deletion.
44 changes: 44 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Contributing to the ConfigCat SDK for Elixir

ConfigCat SDK is an open source project. Feedback and contribution are welcome. Contributions are made to this repo via Issues and Pull Requests.

## Submitting bug reports and feature requests

The ConfigCat SDK team monitors the [issue tracker](https://github.com/configcat/elixir-sdk/issues) in the SDK repository. Bug reports and feature requests specific to this SDK should be filed in this issue tracker. The team will respond to all newly filed issues.

## Submitting pull requests

We encourage pull requests and other contributions from the community.
- Before submitting pull requests, ensure that all temporary or unintended code is removed.
- Be accompanied by a complete Pull Request template (loaded automatically when a PR is created).
- Add unit or integration tests for fixed or changed functionality.

When you submit a pull request or otherwise seek to include your change in the repository, you waive all your intellectual property rights, including your copyright and patent claims for the submission.

In general, we follow the ["fork-and-pull" Git workflow](https://github.com/susam/gitpr)

1. Fork the repository to your own Github account
2. Clone the project to your machine
3. Create a branch locally with a succinct but descriptive name
4. Commit changes to the branch
5. Following any formatting and testing guidelines specific to this repo
6. Push changes to your fork
7. Open a PR in our repository and follow the PR template so that we can efficiently review the changes.

## Build instructions

Install [Elixir](https://elixir-lang.org) development environment.

To install dependencies:

```bash
mix local.rebar --force
mix local.hex --force
mix deps.get
```

## Running tests

```bash
mix test
```
35 changes: 35 additions & 0 deletions DEPLOY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# Steps to deploy
## Preparation
1. Install dependencies
```bash
mix local.rebar --force
mix local.hex --force
mix deps.get
```
1. Run tests
```bash
mix coveralls.json
```
2. Increase the project version in `mix.exs`.
4. Commit & Push
## Publish
Use the **same version** for the git tag as in `mix.exs`.
- Via git tag
1. Create a new version tag.
```bash
git tag v[MAJOR].[MINOR].[PATCH]
```
> Example: `git tag v1.0.1`
2. Push the tag.
```bash
git push origin --tags
```
- Via Github release

Create a new [Github release](https://github.com/configcat/elixir-sdk/releases) with a new version tag and release notes.

## Elixir Package
Make sure the new version is available on [hex.pm](https://hex.pm/packages/configcat).

## Update samples
Update and test sample apps with the new SDK version.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -89,7 +89,7 @@ https://configcat.com/support

## Contributing

Contributions are welcome.
Contributions are welcome. For more info please read the [Contribution Guideline](CONTRIBUTING.md).

## About ConfigCat

0 comments on commit b59a33c

Please sign in to comment.