-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore: added important md to the repo to be equally defined as main l…
…eapp repository
- Loading branch information
Showing
10 changed files
with
721 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,76 @@ | ||
# Contributor Covenant Code of Conduct | ||
|
||
## Our Pledge | ||
|
||
In the interest of fostering an open and welcoming environment, we as | ||
contributors and maintainers pledge to make participation in our project and | ||
our community a harassment-free experience for everyone, regardless of age, body | ||
size, disability, ethnicity, sex characteristics, gender identity and expression, | ||
level of experience, education, socio-economic status, nationality, personal | ||
appearance, race, religion, or sexual identity and orientation. | ||
|
||
## Our Standards | ||
|
||
Examples of behavior that contributes to creating a positive environment | ||
include: | ||
|
||
* Using welcoming and inclusive language | ||
* Being respectful of differing viewpoints and experiences | ||
* Gracefully accepting constructive criticism | ||
* Focusing on what is best for the community | ||
* Showing empathy towards other community members | ||
|
||
Examples of unacceptable behavior by participants include: | ||
|
||
* The use of sexualized language or imagery and unwelcome sexual attention or | ||
advances | ||
* Trolling, insulting/derogatory comments, and personal or political attacks | ||
* Public or private harassment | ||
* Publishing others' private information, such as a physical or electronic | ||
address, without explicit permission | ||
* Other conduct which could reasonably be considered inappropriate in a | ||
professional setting | ||
|
||
## Our Responsibilities | ||
|
||
Project maintainers are responsible for clarifying the standards of acceptable | ||
behavior and are expected to take appropriate and fair corrective action in | ||
response to any instances of unacceptable behavior. | ||
|
||
Project maintainers have the right and responsibility to remove, edit, or | ||
reject comments, commits, code, wiki edits, issues, and other contributions | ||
that are not aligned to this Code of Conduct, or to ban temporarily or | ||
permanently any contributor for other behaviors that they deem inappropriate, | ||
threatening, offensive, or harmful. | ||
|
||
## Scope | ||
|
||
This Code of Conduct applies within all project spaces, and it also applies when | ||
an individual is representing the project or its community in public spaces. | ||
Examples of representing a project or community include using an official | ||
project e-mail address, posting via an official social media account, or acting | ||
as an appointed representative at an online or offline event. Representation of | ||
a project may be further defined and clarified by project maintainers. | ||
|
||
## Enforcement | ||
|
||
Instances of abusive, harassing or otherwise, unacceptable behavior may be | ||
reported by contacting the project team at <[email protected]>. All | ||
complaints will be reviewed and investigated and will result in a response that | ||
is deemed necessary and appropriate to the circumstances. The project team is | ||
obligated to maintain confidentiality with regard to the reporter of an incident. | ||
Further details of specific enforcement policies may be posted separately. | ||
|
||
Project maintainers who do not follow or enforce the Code of Conduct in good | ||
faith may face temporary or permanent repercussions as determined by other | ||
members of the project's leadership. | ||
|
||
## Attribution | ||
|
||
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, | ||
available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html | ||
|
||
[homepage]: https://www.contributor-covenant.org | ||
|
||
For answers to common questions about this code of conduct, see | ||
https://www.contributor-covenant.org/faq |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
<!-- Click on the "Preview" tab to render the instructions in a more readable format --> | ||
|
||
> **Please read the [contribution guidelines](https://github.com/noovolari/leapp-plugin-template/blob/master/CONTRIBUTING.md) before filling out this issue template**. | ||
## [Please follow one of the issue templates](https://github.com/noovolari/leapp-plugin-template/issues/new/choose) | ||
|
||
To keep the backlog clean and actionable, issues should be opened using [one the provided issue templates](https://github.com/noovolari/leapp-plugin-template/issues/new/choose) to help maintainers and the community to understand it, find related reports and to resolve tickets faster. | ||
|
||
### Support | ||
|
||
If you got a question or need help with any aspect of the project feel free to [join the community](https://join.slack.com/t/noovolari/shared_invite/zt-opn8q98k-HDZfpJ2_2U3RdTnN~u_B~Q) and ensure to read the [extensive project documentations](https://docs.leapp.cloud/latest). | ||
|
||
You can also searchFilter for already opened and related issue using the searchFilter for the [“question“](https://github.com/noovolari/leapp-plugin-template/labels/type-question) issue label. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
--- | ||
name: Bug report | ||
about: Create a report to help us improve | ||
title: '' | ||
labels: bug | ||
assignees: '' | ||
|
||
--- | ||
|
||
**Describe the bug** | ||
A clear and concise description of what the bug is. | ||
|
||
**Leapp Version** | ||
Add the version of your Leapp (you can find it under taskbar -> about or Leapp -> about on MacOS X) | ||
|
||
**To Reproduce** | ||
Steps to reproduce the behavior: | ||
1. Go to '...' | ||
2. Click on '....' | ||
3. Scroll down to '....' | ||
4. See error | ||
|
||
**Expected behavior** | ||
A clear and concise description of what you expected to happen. | ||
|
||
**Screenshots** | ||
If applicable, add screenshots to help explain your problem. | ||
|
||
**Desktop (please complete the following information):** | ||
- OS: [e.g. iOS] | ||
- OS Version [e.g. 22] | ||
- Leapp Version [e.g. 0.2.5] | ||
|
||
**Additional context** | ||
Add any other context about the problem here. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,20 @@ | ||
--- | ||
name: Feature request | ||
about: Suggest an idea for this project | ||
title: '' | ||
labels: enhancement | ||
assignees: '' | ||
|
||
--- | ||
|
||
**Is your feature request related to a problem? Please describe.** | ||
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] | ||
|
||
**Describe the solution you'd like** | ||
A clear and concise description of what you want to happen. | ||
|
||
**Describe alternatives you've considered** | ||
A clear and concise description of any alternative solutions or features you've considered. | ||
|
||
**Additional context** | ||
Add any other context or screenshots about the feature request here. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,16 @@ | ||
**Changelog** | ||
|
||
List of new feature and/or fixes here. | ||
|
||
**Bugfixes** | ||
|
||
Describe the fixes and specifying the issue if related. | ||
|
||
**Enhancements** | ||
|
||
Describe the enhancements specifying the issue if related. | ||
|
||
**Notes** | ||
|
||
Write eventual notes or reminders specifying if you have any sort of reference | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,3 @@ | ||
node_modules | ||
plugin.js | ||
.idea |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,196 @@ | ||
# Contributing to Leapp Plugin Template | ||
|
||
First of all, thank you for contributing to Leapp Project! | ||
|
||
The goal of this document is to **provide all the information you need to start contributing.** | ||
|
||
Please, feel free to propose changes to this document in a pull request [Pull Request template](https://github.com/Noovolari/leapp-plugin-template/blob/master/.github/PULL_REQUEST_TEMPLATE.md). | ||
|
||
Contributions and questions are not just welcome, **they’re essential!** | ||
|
||
Please open issues with ideas on how to improve the Leapp Plugin Template, including feedback, critiques, and information about how you’re using it. Discussion is at the heart of the project and your thoughts and ideas will help make it better for everyone, thank you. 💙 | ||
|
||
You can chat with us inside our community so [join us](https://join.slack.com/t/noovolari/shared_invite/zt-noc0ju05-18_GRX~Zi6Jz8~95j5CySA), or feel free to contact us via the email at [email protected]. | ||
|
||
# Code of Conduct | ||
|
||
Here in Leapp, we aim to create great things by collaborating in the most respectful, inclusive, and effective way possible. This way to work is governed by a Code of Conduct document [Contributor Covenant Code of Conduct](./.github/CODE_OF_CONDUCT.md). | ||
|
||
# How can I contribute? | ||
|
||
You can start contributing to Leapp Plugin Template by | ||
|
||
- [Reporting bugs](#reporting-bugs) | ||
- [Suggesting enhancements or new features](#suggesting-enhancements-or-new-features) | ||
- [Submitting your first code contribution](#your-first-code-contribution) | ||
|
||
Any other idea to contribute that we missed? Submit a Pull Request to share it with us! | ||
|
||
[GitHub Issues](https://github.com/Noovolari/leapp-plugin-template/issues) is the preferred contribution channel, but not the only one! You can suggest enhancements or new features in Leapp’s [public roadmap](https://roadmap.leapp.cloud/tabs/4-in-progress). | ||
|
||
When creating a new issue through the [GitHub Issues](https://github.com/Noovolari/leapp-plugin-template/issues) channel, it’s really important to understand if it is a “beginner-friendly” one. Beginner-friendly issues can be a good starting point for new contributors; that’s the reason why you can label them as “good first issue”. Visit [here](https://github.com/noovolari/leapp-plugin-template/contribute) and make your first contribution to this repository by tackling one of the listed good first issues. | ||
|
||
Contributors can start contributing even in “help wanted” issues. These are issues maintainers want help on. | ||
|
||
Please respect the following restrictions: | ||
|
||
- Please **do not** use the issue tracker for personal support requests email [email protected]. | ||
- Please **do not** derail or troll issues. Keep the discussion on topic and respect the opinions of others. | ||
|
||
## Reporting bugs | ||
|
||
A bug is a *demonstrable problem* that is caused by the code in the repository. | ||
|
||
Prior to reporting a bug, please check if it is already tracked using the GitHub issue search. If it is marked as fixed but you are still experiencing it, add a comment to the issue’s discussion so that we can re-open it. | ||
|
||
To report a new bug we ask you to follow the template that you can find [here](https://github.com/Noovolari/leapp-plugin-template/issues/new?assignees=&labels=bug&template=bug-report.md&). | ||
|
||
This template guides you during the definition of the bug. It includes: | ||
|
||
- a description of the bug; | ||
- the Leapp’s version you encountered the bug with; | ||
- the steps needed to reproduce the bug; | ||
- the behavior you expected from the application in the described context; | ||
- optional screenshots that provide information to further describe the context; | ||
- information about the local system you are running Leapp on; | ||
- additional context; | ||
- how it is important to you (nice to have, important, critical). | ||
|
||
|
||
## Suggesting enhancements or new features | ||
|
||
Feature requests are welcome. But take a moment to find out whether your idea | ||
fits with the scope and aims of the project. It's up to *you* to make a strong | ||
case to convince the project's developers of the merits of this feature. **Please | ||
provide as much detail and context as possible.** | ||
|
||
As for bug reporting, there is a template for new feature requests too. You can find it [here](https://github.com/Noovolari/leapp-plugin-template/issues/new?assignees=&labels=enhancement&template=feature_request.md). It includes: | ||
|
||
- a description of an eventual problem the feature is related to; | ||
- a description of the solution you would like; | ||
- eventual different alternatives you’ve considered; | ||
- additional context; | ||
- how it is important to you (nice to have, important, critical). | ||
|
||
You can even submit your feature request idea from our [public roadmap board](https://roadmap.leapp.cloud/tabs/4-in-progress). | ||
|
||
Please consult the [public roadmap](https://roadmap.leapp.cloud/tabs/4-in-progress) to get an overview of new ideas that were accepted by Leapp maintainers. | ||
|
||
## ****Your First Code Contribution**** | ||
|
||
Do you want to implement something from scratch or fix an issue? | ||
|
||
This is the first time you’re contributing to Leapp. “good first issues” and “help wanted” issues could be a nice starting point for you to get your hands dirty with the codebase. | ||
|
||
For more info about how to start developing and proposing changes, please refer to the [DEVELOPMENT.md](./DEVELOPMENT.md) document. | ||
|
||
# Conventional Commits | ||
|
||
This project uses [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/). Examples: | ||
|
||
``` | ||
feat: Add new cloud provider | ||
docs: Fix typo in Readme | ||
``` | ||
|
||
You can find the list of supported commit types [here](https://github.com/conventional-changelog/commitlint/blob/master/%40commitlint/config-conventional/README.md#type-enum). | ||
|
||
Please ensure to always write a clear log message for your commits. One-line messages are fine for small changes, bigger changes should include more context to understand the change quickly. Example: | ||
|
||
``` | ||
$ git commit -m "feat: a brief summary of the commit | ||
> | ||
> A paragraph describing what changed and its impact." | ||
``` | ||
|
||
We rely on both [husky](https://github.com/typicode/husky) and [commitlint](https://github.com/conventional-changelog/commitlint) to check if the commit follows conventional commits’ guidelines. | ||
|
||
Before submitting your Pull Request, take your time to squash the commits related to your fix/feature. The same convention is applied to the Pull Request name; we suggest making the commit name match with the Pull Request one. | ||
|
||
# Pull Requests | ||
|
||
Good pull requests (patches, improvements, new features) are a fantastic | ||
help. They should remain focused on the scope and avoid containing unrelated | ||
commits. | ||
|
||
**Please ask first** before embarking on any significant pull request (e.g. | ||
implementing features, refactoring code, porting to a different language), | ||
otherwise, you risk spending a lot of time working on something that might | ||
not get accepted into the project. | ||
|
||
**IMPORTANT**: by submitting a patch, you agree to allow the project owner to | ||
license your work under the same license as that used by the project. | ||
|
||
Please send a [GitHub Pull Request to Leapp](https://github.com/noovolari/leapp-plugin-template/pull/new/master) with a clear list of what you have changed. Tip: Learn more about [pull requests](http://help.github.com/pull-requests/)). | ||
|
||
# Developer Certification of Origin (DCO) | ||
|
||
Leapp requires the Developer Certificate of Origin (DCO) process to be followed. | ||
|
||
The DCO is an attestation attached to every contribution made by every developer. In the commit message of the contribution, the developer simply adds a Signed-off-by statement and thereby agrees to the DCO, which you can find below or at [http://developercertificate.org/](http://developercertificate.org/). | ||
|
||
``` | ||
Developer's Certificate of Origin 1.1 | ||
By making a contribution to this project, I certify that: | ||
(a) The contribution was created in whole or in part by me and I | ||
have the right to submit it under the open source license | ||
indicated in the file; or | ||
(b) The contribution is based upon previous work that, to the | ||
best of my knowledge, is covered under an appropriate open | ||
source license and I have the right under that license to | ||
submit that work with modifications, whether created in whole | ||
or in part by me, under the same open source license (unless | ||
I am permitted to submit under a different license), as | ||
Indicated in the file; or | ||
(c) The contribution was provided directly to me by some other | ||
person who certified (a), (b) or (c) and I have not modified | ||
it. | ||
(d) I understand and agree that this project and the contribution | ||
are public and that a record of the contribution (including | ||
all personal information I submit with it, including my | ||
sign-off) is maintained indefinitely and may be redistributed | ||
consistent with this project or the open source license(s) | ||
involved. | ||
``` | ||
|
||
### DCO Sign-Off Methods | ||
|
||
The DCO requires a sign-off message in the following format appear on each commit in the pull request: | ||
|
||
``` | ||
Signed-off-by: John Doe <[email protected]> | ||
``` | ||
|
||
The DCO text can either be manually added to your commit body, or you can add either **-s** or **--signoff** to your usual git commit commands. If you are using the GitHub UI to make a change you can add the sign-off message directly to the commit message when creating the pull request. If you forget to add the sign-off you can also amend a previous commit with the sign-off by running **git commit --amend -s**. If you've pushed your changes to GitHub already you'll need to force push your branch after this with **git push -f**. | ||
|
||
Example for updating a PR after missing the sign-off: | ||
|
||
``` | ||
$ git clone <https://github.com/><yournamespace>/leapp.git | ||
$ cd leapp | ||
$ git checkout <branch-name-in-your-fork> | ||
$ git commit --amend -s | ||
$ git push -f | ||
``` | ||
|
||
If there are multiple commits to be signed off, you can use **git rebase --signoff HEAD~<number-of-changes** since Git 2.12. Example for the latest 2 commits: | ||
|
||
``` | ||
$ git rebase --signoff HEAD~2 | ||
$ git push -f | ||
``` | ||
|
||
For more info about the sign-off process, please refer to [this](https://www.secondstate.io/articles/dco/) guide by WasmEdge. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
# What should I know before I get started? | ||
If you want to start a code contribution to Leapp Plugin Template, whether it is a bug fix or a new feature, it is important for you to understand Leapp concepts and way to work. | ||
|
||
# Development | ||
|
||
Please refer to the [README.md](README.md) document. | ||
|
||
# Conventional Commits and Pull Request | ||
|
||
Please refer to the [CONTRIBUTING.md](CONTRIBUTING.md) document. |
Oops, something went wrong.