Skip to content

Commit

Permalink
chore: update README.md to add contributing
Browse files Browse the repository at this point in the history
  • Loading branch information
ThibaudAV committed Nov 5, 2021
1 parent 3ac3d58 commit ba4d564
Show file tree
Hide file tree
Showing 2 changed files with 82 additions and 3 deletions.
75 changes: 75 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# Contributing to Gravitee.io

You think Gravitee.io is awesome and want to contribute to the project?
Here are few guidelines that should help you get started.

## Using GitHub issues

Found a bug in the source code? Or wants to propose new features or enhancements?
You can help us by submitting an issue in the [repository](https://github.com/gravitee-io/gravitee-ui-particles).
Before submitting your issue, search in the [archive issues](https://github.com/gravitee-io/issues/issues) if it doesn't have already been answered.

Providing the following information will help us to deal quickly with your issue :

- **Overview of the issue** : describe the issue and why this is a bug for you.
- **You have stack trace, screenshots, logs?** add these to the issue's description.

## Submitting changes

You've submitted an issue to the project and know how to fix it? You can contribute to the project by [forking the repository](https://guides.github.com/activities/forking) and [submitting your pull requests](https://guides.github.com/activities/forking/#making-a-pull-request).

Before submitting your pull request consider the following guidelines:

- Make your changes in a new git branch:

```shell
git checkout -b issue-<issue-id>-my-fix-branch main
```

Note : issue-id reference the id generated by GitHub (#issue-id).

- Create your patch, **including appropriate test cases**.
- Update the documentation if you create new features or think the documentation needs to be updated/completed.
- Build your changes locally to **ensure all the linters rules and test pass**

```shell
yarn lint
yarn test
```

- Commit your changes using a descriptive commit message.

```shell
git commit -a
```

- Push your branch to GitHub:

```shell
git push origin issue-<issue-id>-my-fix-branch
```

- In GitHub, send a pull request to `<gravitee-io/gravitee-ui-particles>:main`.

- If we suggest changes then:
** Make the required updates.
** Re-run the test suite to ensure tests are still passing.
** Commit your changes to your branch (e.g. `issue/<issue-id>-my-fix-branch`).
** Push the changes to your GitHub repository (this will update your Pull Request).

If the PR gets too outdated we may ask you to rebase and force push to update the PR:

```shell
git rebase main
git push origin issue-<issue-id>-my-fix-branch -f
```

That's it! You've just contributed to the project, and we really appreciate it!

## Contributor License Agreement

Please sign our [Contributor License Agreement (CLA)](https://download.gravitee.io/cla.pdf) and send it to contact@graviteesource.com. For any code changes to be accepted, the CLA must be signed.

## Further Information

You can find more detailed information about contributing in the [Github guides](https://guides.github.com/activities/contributing-to-open-source).
10 changes: 7 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,16 @@

Gravitee Ui Particles centralizes the design system applied to to all Gravitee consoles

This project is a Yarn workspace

## Gravitee Ui Particles 🅰️ ngular

[![CircleCI](https://circleci.com/gh/gravitee-io/gravitee-ui-particles/tree/main.svg?style=svg)](https://circleci.com/gh/gravitee-io/gravitee-ui-particles/tree/main)

:books: [Storybook](https://main--6183b02d73381a003a3be1a6.chromatic.com/)
Workspace project for the Angular framework. This project is itself an Angular workspace created by angular-cli.
it contains (currently) only one library `projects/ui-particles-angular`

📚 Go see the showcase of this project with : [Storybook](https://main--6183b02d73381a003a3be1a6.chromatic.com/)

### Install

Expand All @@ -28,8 +33,7 @@ npm login --scope=@gravitee-io --registry=https://npm.pkg.github.com
## Contributing

You think Gravitee.io is awesome and want to contribute to the project?

TODO :gmaisse-psychédélique:
Here are few [guidelines](https://github.com/gravitee-io/gravitee-ui-particles/blob/master/CONTRIBUTING.md) that should help you get started.

## Copyright

Expand Down

0 comments on commit ba4d564

Please sign in to comment.