This repository has been archived by the owner on Apr 1, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 299
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
211 changed files
with
32,219 additions
and
26,914 deletions.
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 |
|---|---|---|
| @@ -1,3 +1,18 @@ | ||
| # Comment to be posted to on first time issues | ||
| newIssueWelcomeComment: > | ||
| Hello and welcome to the Oni repository! Thanks for opening your first issue here. To help us out, please make sure to include as much detail as possible - including screenshots and logs, if possible. | ||
| backers: | ||
| - 13532591 | ||
| - 5097613 | ||
| - 22454918 | ||
| - 347552 | ||
| - 977348 | ||
| - 28748 | ||
| - 2835826 | ||
| - 515720 | ||
| - 124171 | ||
| - 230476 | ||
| - 10102132 | ||
| - 10038688 | ||
| - 817509 | ||
| - 163128 |
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
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 @@ | ||
| 9 |
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,2 @@ | ||
| package.json | ||
| vim/core/oni-plugin-typescript/package.json |
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
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
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
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
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 |
|---|---|---|
|
|
@@ -4,31 +4,64 @@ | |
|
|
||
| First, thank you for considering contributing to oni! It's people like you that make the open source community such a great community! 😊 | ||
|
|
||
| We welcome any type of contribution, not only code. You can help with | ||
| - **QA**: file bug reports, the more details you can give the better (e.g. screenshots with the console open) | ||
| - **Marketing**: writing blog posts, howto's, printing stickers, ... | ||
| - **Community**: presenting the project at meetups, organizing a dedicated meetup for the local community, ... | ||
| - **Code**: take a look at the [open issues](issues). Even if you can't write code, commenting on them, showing that you care about a given issue matters. It helps us triage them. | ||
| - **Money**: we welcome financial contributions in full transparency on our [open collective](https://opencollective.com/oni). | ||
| We welcome any type of contribution, not only code. You can help with | ||
|
|
||
| * **QA**: file bug reports, the more details you can give the better (e.g. screenshots with the console open) | ||
| * **Marketing**: writing blog posts, howto's, printing stickers, ... | ||
| * **Community**: presenting the project at meetups, organizing a dedicated meetup for the local community, ... | ||
| * **Code**: take a look at the [open issues](issues). Even if you can't write code, commenting on them, showing that you care about a given issue matters. It helps us triage them. | ||
| * **Money**: we welcome financial contributions in full transparency on our [open collective](https://opencollective.com/oni). | ||
|
|
||
| ## Your First Contribution | ||
|
|
||
| Working on your first Pull Request? You can learn how from this *free* series, [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github). | ||
| Working on your first Pull Request? You can learn how from this _free_ series, [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github). | ||
|
|
||
| ## Submitting code | ||
|
|
||
| Any code change should be submitted as a pull request. The description should explain what the code does and give steps to execute it. The pull request should also contain tests. | ||
| Any code change should be submitted as a pull request. The description should explain what the code does and give steps to execute it. The pull request should also contain tests. We welcome and appreciate pull requests! | ||
|
|
||
| ## Code review guidelines | ||
|
|
||
| ## Code review process | ||
| * Keep PRs **small and scoped**. The bigger the pull request, the longer it will take to review and merge. Break down large pull requests into smaller incremental chunks - this will help catch issues earlier and be easier on both you and the maintainer. | ||
| * Following from the previous bullet point, **do not include unrelated changes in a PR**. It can be tempting to include extra styling changes or additional functionality, but these should be added as separate PRs. | ||
| * Think of each PR as **improving the quality of the codebase**. Codebases tend towards entropy and disorder unless actively managed - make sure that your change moves the quality needle in the right direction. This can take a variety of forms, including adding test coverage, reducing coupling, etc. _As we are a small team moving fast, we cannot afford to accumulate technical debt._ | ||
| * If there is ambiguity in terms of design, architecture, or implementation, it's best to get **feedback before implementing**, to save both you and the maintainer time. If you're not sure, feel free to ask! | ||
| * For your first few PRs, **don't try and change the world** - pick some small issues and get familiar with the codebase. Then, work your way up to bigger issues - this will set you up for success. | ||
|
|
||
| The bigger the pull request, the longer it will take to review and merge. Try to break down large pull requests in smaller chunks that are easier to review and merge. | ||
| It is also always helpful to have some context for your pull request. What was the purpose? Why does it matter to you? | ||
| PRs require approval from one other person, either a maintainer or a contributor. Keep in mind that when you approve code, you are accountable for it, too! Reviewers are the gatekeepers of quality and ensuring adherence to the guidelines above. | ||
|
|
||
| ## Financial contributions | ||
|
|
||
| We also welcome financial contributions in full transparency on our [open collective](https://opencollective.com/oni). | ||
| Anyone can file an expense. If the expense makes sense for the development of the community, it will be "merged" in the ledger of our open collective by the core contributors and the person who filed the expense will be reimbursed. | ||
|
|
||
| ### Bounties | ||
|
|
||
| The primary allotment of our [open collective](https://opencollective.com/oni) budget is dedicated to bounties. Developing features and fixing bugs is a loit of work, and those go directly to the developers doing this work via bounties. It is the role of the _maintainer_ to set bounties and clear completion criteria. Issues that have a bounty associated with them will have a `bounty` label as well as an amount, ie, `bounty-50` means a $50 bounty. | ||
|
|
||
| * Guidelines: | ||
| * The fix for the bug/feature/issue _MUST_ be complete and _MUST_ be covered by tests to be eligible for a bounty. | ||
| * If you begin working on an issue with an associated bounty, open a PR with "WIP" and the bug number in the title, as well as reference the issue #. This is important to reduce duplicate work. | ||
| * Upon completion, bounties are payable via an [open collective expense]. | ||
|
|
||
| If you questions about the guidelines, please don't hesitate to contact the maintainer. | ||
|
|
||
| ## Roles | ||
|
|
||
| There are various roles and responsibilities in managing an open-source project. Users that are active and have a positive impact on the project and community will be recognized and have the option of assuming additional responsibilities. | ||
|
|
||
| * **Maintainer** - A maintainer communicates goals and drives the vision for the project. The maintainer is responsible for breaking down hurdles and supporting contributors. In addition, the maintainer triages issues, produces releases, assigns bounties, and establishes completion criteria. Today, there is one maintainer, but that isn't a strict requirement. | ||
| * **Collaborator** - A collaborator is an established member of the project that is recognized for their impact and contributions. They can triage and close issues, approve PRs from other contributors / collaborators, and can approve expenses on our [open collective](https://opencollective.com/oni) | ||
| * **Contributor** - A contributor is a developer that has submitted a successful PR for the project. | ||
|
|
||
| ### Becoming a collaborator | ||
|
|
||
| A collaborator is a contributor who has been recognized for the impact they've had on the project, over a sustained period of time. In general, this means the following: | ||
|
|
||
| * **Supporting the community** - helping others in issues and chat, supporting new developers, creating a positive and supportive environment. | ||
| * **Technical impact** - involvement in a core technical piece of the editor, or a broad impact on the ecosystem. | ||
| * **Positive and collaborative mindset** - creating good vibes, willingness to give and receive constructive feedback, being a team player. | ||
|
|
||
| ## Questions | ||
|
|
||
| If you have any questions, create an [issue](issue) (protip: do a quick search first to see if someone else didn't ask the same question before!). | ||
|
|
@@ -41,14 +74,12 @@ You can also reach us at [email protected]. | |
| Thank you to all the people who have already contributed to oni! | ||
| <a href="graphs/contributors"><img src="https://opencollective.com/oni/contributors.svg?width=890" /></a> | ||
|
|
||
|
|
||
| ### Backers | ||
|
|
||
| Thank you to all our backers! [[Become a backer](https://opencollective.com/oni#backer)] | ||
|
|
||
| <a href="https://opencollective.com/oni#backers" target="_blank"><img src="https://opencollective.com/oni/backers.svg?width=890"></a> | ||
|
|
||
|
|
||
| ### Sponsors | ||
|
|
||
| Thank you to all our sponsors! (please ask your company to also support this open source project by [becoming a sponsor](https://opencollective.com/oni#sponsor)) | ||
|
|
@@ -64,4 +95,4 @@ Thank you to all our sponsors! (please ask your company to also support this ope | |
| <a href="https://opencollective.com/oni/sponsor/8/website" target="_blank"><img src="https://opencollective.com/oni/sponsor/8/avatar.svg"></a> | ||
| <a href="https://opencollective.com/oni/sponsor/9/website" target="_blank"><img src="https://opencollective.com/oni/sponsor/9/avatar.svg"></a> | ||
|
|
||
| <!-- This `CONTRIBUTING.md` is based on @nayafia's template https://github.com/nayafia/contributing-template --> | ||
| <!-- This `CONTRIBUTING.md` is based on @nayafia's template https://github.com/nayafia/contributing-template --> | ||
Oops, something went wrong.