Skip to content

Commit 44b370d

Browse files
committed
fix: yarn and CONTRIBUTING
1 parent 41d1557 commit 44b370d

File tree

2 files changed

+1332
-1262
lines changed

2 files changed

+1332
-1262
lines changed

CONTRIBUTING.md

Lines changed: 28 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,57 +1,43 @@
1-
*This is a suggested `CONTRIBUTING.md` file template for use by open sourced Salesforce projects. The main goal of this file is to make clear the intents and expectations that end-users may have regarding this project and how/if to engage with it. Adjust as needed (especially look for `{project_slug}` which refers to the org and repo name of your project) and remove this paragraph before committing to your repo.*
2-
3-
# Contributing Guide For {NAME OF PROJECT}
1+
# Contributing Guide For data-code-extension
42

53
This page lists the operational governance model of this project, as well as the recommendations and requirements for how to best contribute to {PROJECT}. We strive to obey these as best as possible. As always, thanks for contributing – we hope these guidelines make it easier and shed some light on our approach and processes.
64

75
# Governance Model
6+
87
> Pick the most appropriate one
98
109
## Community Based
1110

1211
The intent and goal of open sourcing this project is to increase the contributor and user base. The governance model is one where new project leads (`admins`) will be added to the project based on their contributions and efforts, a so-called "do-acracy" or "meritocracy" similar to that used by all Apache Software Foundation projects.
1312

14-
> or
15-
16-
## Salesforce Sponsored
17-
18-
The intent and goal of open sourcing this project is to increase the contributor and user base. However, only Salesforce employees will be given `admin` rights and will be the final arbitrars of what contributions are accepted or not.
19-
20-
> or
21-
22-
## Published but not supported
23-
24-
The intent and goal of open sourcing this project is because it may contain useful or interesting code/concepts that we wish to share with the larger open source community. Although occasional work may be done on it, we will not be looking for or soliciting contributions.
25-
26-
# Getting started
27-
28-
Please join the community on {Here list Slack channels, Email lists, Glitter, Discord, etc... links}. Also please make sure to take a look at the project [roadmap](ROADMAP.md) to see where are headed.
29-
3013
# Issues, requests & ideas
3114

3215
Use GitHub Issues page to submit issues, enhancement requests and discuss ideas.
3316

3417
### Bug Reports and Fixes
35-
- If you find a bug, please search for it in the [Issues](https://github.com/{project_slug}/issues), and if it isn't already tracked,
36-
[create a new issue](https://github.com/{project_slug}/issues/new). Fill out the "Bug Report" section of the issue template. Even if an Issue is closed, feel free to comment and add details, it will still
37-
be reviewed.
38-
- Issues that have already been identified as a bug (note: able to reproduce) will be labelled `bug`.
39-
- If you'd like to submit a fix for a bug, [send a Pull Request](#creating_a_pull_request) and mention the Issue number.
40-
- Include tests that isolate the bug and verifies that it was fixed.
18+
19+
- If you find a bug, please search for it in the [Issues](https://github.com/{project_slug}/issues), and if it isn't already tracked,
20+
[create a new issue](https://github.com/{project_slug}/issues/new). Fill out the "Bug Report" section of the issue template. Even if an Issue is closed, feel free to comment and add details, it will still
21+
be reviewed.
22+
- Issues that have already been identified as a bug (note: able to reproduce) will be labelled `bug`.
23+
- If you'd like to submit a fix for a bug, [send a Pull Request](#creating_a_pull_request) and mention the Issue number.
24+
- Include tests that isolate the bug and verifies that it was fixed.
4125

4226
### New Features
43-
- If you'd like to add new functionality to this project, describe the problem you want to solve in a [new Issue](https://github.com/{project_slug}/issues/new).
44-
- Issues that have been identified as a feature request will be labelled `enhancement`.
45-
- If you'd like to implement the new feature, please wait for feedback from the project
46-
maintainers before spending too much time writing the code. In some cases, `enhancement`s may
47-
not align well with the project objectives at the time.
27+
28+
- If you'd like to add new functionality to this project, describe the problem you want to solve in a [new Issue](https://github.com/{project_slug}/issues/new).
29+
- Issues that have been identified as a feature request will be labelled `enhancement`.
30+
- If you'd like to implement the new feature, please wait for feedback from the project
31+
maintainers before spending too much time writing the code. In some cases, `enhancement`s may
32+
not align well with the project objectives at the time.
4833

4934
### Tests, Documentation, Miscellaneous
50-
- If you'd like to improve the tests, you want to make the documentation clearer, you have an
51-
alternative implementation of something that may have advantages over the way its currently
52-
done, or you have any other change, we would be happy to hear about it!
53-
- If its a trivial change, go ahead and [send a Pull Request](#creating_a_pull_request) with the changes you have in mind.
54-
- If not, [open an Issue](https://github.com/{project_slug}/issues/new) to discuss the idea first.
35+
36+
- If you'd like to improve the tests, you want to make the documentation clearer, you have an
37+
alternative implementation of something that may have advantages over the way its currently
38+
done, or you have any other change, we would be happy to hear about it!
39+
- If its a trivial change, go ahead and [send a Pull Request](#creating_a_pull_request) with the changes you have in mind.
40+
- If not, [open an Issue](https://github.com/{project_slug}/issues/new) to discuss the idea first.
5541

5642
If you're new to our project and looking for some way to make your first contribution, look for
5743
Issues labelled `good first contribution`.
@@ -75,9 +61,9 @@ Issues labelled `good first contribution`.
7561

7662
# Creating a Pull Request
7763

78-
1. **Ensure the bug/feature was not already reported** by searching on GitHub under Issues. If none exists, create a new issue so that other contributors can keep track of what you are trying to add/fix and offer suggestions (or let you know if there is already an effort in progress).
79-
3. **Clone** the forked repo to your machine.
80-
4. **Create** a new branch to contain your work (e.g. `git br fix-issue-11`)
64+
1. **Ensure the bug/feature was not already reported** by searching on GitHub under Issues. If none exists, create a new issue so that other contributors can keep track of what you are trying to add/fix and offer suggestions (or let you know if there is already an effort in progress).
65+
2. **Clone** the forked repo to your machine.
66+
3. **Create** a new branch to contain your work (e.g. `git br fix-issue-11`)
8167
4. **Commit** changes to your own branch.
8268
5. **Push** your work back up to your fork. (e.g. `git push fix-issue-11`)
8369
6. **Submit** a Pull Request against the `main` branch and refer to the issue(s) you are fixing. Try not to pollute your pull request with unintended changes. Keep it simple and small.
@@ -86,17 +72,21 @@ Issues labelled `good first contribution`.
8672
> **NOTE**: Be sure to [sync your fork](https://help.github.com/articles/syncing-a-fork/) before making a pull request.
8773
8874
# Contributor License Agreement ("CLA")
75+
8976
In order to accept your pull request, we need you to submit a CLA. You only need
9077
to do this once to work on any of Salesforce's open source projects.
9178

9279
Complete your CLA here: <https://cla.salesforce.com/sign-cla>
9380

9481
# Issues
82+
9583
We use GitHub issues to track public bugs. Please ensure your description is
9684
clear and has sufficient instructions to be able to reproduce the issue.
9785

9886
# Code of Conduct
87+
9988
Please follow our [Code of Conduct](CODE_OF_CONDUCT.md).
10089

10190
# License
91+
10292
By contributing your code, you agree to license your contribution under the terms of our project [LICENSE](LICENSE.txt) and to sign the [Salesforce CLA](https://cla.salesforce.com/sign-cla)

0 commit comments

Comments
 (0)