Skip to content

Commit 7d93900

Browse files
committed
create contributing guide, move code of conduct to separate file, add issue template
1 parent 6b02ef1 commit 7d93900

File tree

4 files changed

+71
-31
lines changed

4 files changed

+71
-31
lines changed

CODE_OF_CONDUCT.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# p5.js Code of Conduct
2+
3+
* **Be mindful of your language.** Any of the following behavior is unacceptable:
4+
* Offensive comments related to gender identity and expression, sexual orientation, race, ethnicity, language, neuro-type, size, ability, class, religion, culture, subculture, political opinion, age, skill level, occupation, or background
5+
* Threats of violence
6+
* Deliberate intimidation
7+
* Sexually explicit or violent material
8+
* Unwelcome sexual attention
9+
* Stalking or following
10+
* Or any other kinds of harassment
11+
12+
Use your best judgement. If it will possibly make others uncomfortable, do not post it.
13+
14+
* **Be respectful.** Disagreement is not an opportunity to attack someone else's thoughts or opinions. Although views may differ, remember to approach every situation with patience and care.
15+
* **Be considerate.** Think about how your contribution will affect others in the community.
16+
* **Be open minded.** Embrace new people and new ideas. Our community is continually evolving and we welcome positive change.
17+
18+
If you believe someone is violating the code of conduct, we ask that you report it by emailing [hello@p5js.org](mailto:hello@p5js.org). Please include your name and a description of the incident, and we will get back to you ASAP.
19+
20+
Participants asked to stop any harassing behavior are expected to comply immediately. If a participant engages in harassing behavior, the p5.js Team may take any action they deem appropriate, up to and including expulsion from all p5.js spaces and identification of the participant as a harasser to other p5.js members or the general public.
21+
22+
## Also
23+
* You can read our [community statement](http://p5js.org/community/) on our website.

ISSUE_TEMPLATE.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
<!--
2+
Hi there! If you are here to report a bug, or to discuss a feature (new or existing), you can use the below template to get started quickly. Fill out all those parts which you're comfortable with, and delete the remaining ones.
3+
4+
To check any option, replace the "[ ]" with a "[x]". Be sure to check out how it looks in the Preview tab!
5+
6+
Feel free to remove any portion of the template that is not relevant for your issue.
7+
-->
8+
9+
#### Nature of issue?
10+
11+
- [ ] Found a bug
12+
- [ ] Existing feature enhancement
13+
- [ ] New feature request
14+
15+
<!-- If you found a bug, the following information might prove to be helpful for us. Simply remove whatever you can't determine/don't know. -->
16+
#### Details about the bug:
17+
18+
- Web browser and version: <!-- On Chrome/FireFox/Opera you can enter "about:" in the address bar to find out the version -->
19+
- Operating System: <!-- Ex: Windows/MacOSX/Linux along with version -->
20+
- Steps to reproduce this:
21+
<!-- Include a simple code snippet that demonstrates the problem, along with any console errors produced. If this isn't possible, then simply describe the issue as best you can! Feel free to link to the web editor or include pictures or a video. -->
22+
23+
<!-- If you want to enhance an existing feature, please describe here, otherwise remove this section -->
24+
#### Feature enhancement details:
25+
26+
27+
<!-- If you want to request a new feature, please describe here, otherwise remove this section -->
28+
#### New feature details:

README.md

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,14 @@ This project is currently in development! It will be announced when there is a (
44

55
## Development Installation
66

7-
1. Clone this repostory and cd into it
8-
2. `$ git submodule init`
9-
3. `$ npm install`
10-
4. Install MongoDB and make sure it is running
7+
1. Fork this repository.
8+
2. Clone the forked repostory and cd into it
9+
3. `$ git submodule init`
10+
4. `$ npm install`
11+
5. Install MongoDB and make sure it is running
1112
* For Mac OSX with [homebrew](http://brew.sh/): `brew install mongodb` then `brew services start mongodb`
1213
* For Windows and Linux: [MongoDB Installation](https://docs.mongodb.com/manual/installation/)
13-
5. Create a file called `.env` in the root of this directory that looks like
14+
6. Create a file called `.env` in the root of this directory that looks like
1415

1516
```
1617
API_URL=/api
@@ -26,10 +27,10 @@ This project is currently in development! It will be announced when there is a (
2627
```
2728
If you don't care about being able to upload media files to S3 or Login with Github, you can drop in the file exactly how it is. Or, if you don't want to do that, just ask me to send you mine. Refer to [this gist](https://gist.github.com/catarak/70c9301f0fd1ac2d6b58de03f61997e3) for creating an S3 bucket for testing, or if you don't want to do that, I can add you to one of my S3 buckets.
2829

29-
6. `$ npm run fetch-examples` - this downloads the example sketches into a user called 'p5'
30-
7. `$ npm start`
31-
8. Navigate to [http://localhost:8000](http://localhost:8000) in your browser
32-
9. Install the [React Developer Tools](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi?hl=en).
30+
7. `$ npm run fetch-examples` - this downloads the example sketches into a user called 'p5'
31+
8. `$ npm start`
32+
9. Navigate to [http://localhost:8000](http://localhost:8000) in your browser
33+
10. Install the [React Developer Tools](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi?hl=en).
3334
10. Open and close the Redux DevTools using `ctrl+h`, and move them with `ctrl+w`
3435

3536
### Testing SSL on your local machine
@@ -91,8 +92,11 @@ The code for the p5.js web editor adheres to web accessibility standards. The fo
9192

9293
For more information on accessibility see the [teach access tutorial](https://teachaccess.github.io/tutorial/)
9394

94-
## Contribution Guide
95-
I am currently open to contributors! Email me if you are looking for a task, or look at the open issues and reply that you are working on a task.
95+
## Contributing
96+
97+
See [CONTRIBUTING.md](https://github.com/processing/p5.js-web-editor/blob/master/contributing.md).
98+
99+
## Tooling and Style Overview
96100

97101
The p5.js Web Editor is built on a MERN stack - MongoDB, Express, React/Redux, and Node. For a reference to the file structure format I am using, please look at the [Mern Starter](https://github.com/Hashnode/mern-starter) and [this comment](https://github.com/Hashnode/mern-starter/issues/90#issuecomment-221553573).
98102

contributing.md

Lines changed: 5 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,9 @@
1-
# p5.js Code of Conduct
1+
# Contributing to the p5.js web editor
22

3-
* **Be mindful of your language.** Any of the following behavior is unacceptable:
4-
* Offensive comments related to gender identity and expression, sexual orientation, race, ethnicity, language, neuro-type, size, ability, class, religion, culture, subculture, political opinion, age, skill level, occupation, or background
5-
* Threats of violence
6-
* Deliberate intimidation
7-
* Sexually explicit or violent material
8-
* Unwelcome sexual attention
9-
* Stalking or following
10-
* Or any other kinds of harassment
3+
We welcome community contributions to the p5.js web editor! You can contribute even if you are not a developer by documenting bugs, proposing new features, and updating documentation.
114

12-
Use your best judgement. If it will possibly make others uncomfortable, do not post it.
5+
When opening an issue, be sure to clearly describe the issue, task, or feature. If it is a bug, try to include steps to reproduce or other contextual information, such as the browser or operating system.
136

14-
* **Be respectful.** Disagreement is not an opportunity to attack someone else's thoughts or opinions. Although views may differ, remember to approach every situation with patience and care.
15-
* **Be considerate.** Think about how your contribution will affect others in the community.
16-
* **Be open minded.** Embrace new people and new ideas. Our community is continually evolving and we welcome positive change.
7+
Feel free to work on any open issue, though make sure you reply that you are working on it. first-timers-only and help-wanted tagged issues are coming soon :smile:
178

18-
If you believe someone is violating the code of conduct, we ask that you report it by emailing [hello@p5js.org](mailto:hello@p5js.org). Please include your name and a description of the incident, and we will get back to you ASAP.
19-
20-
Participants asked to stop any harassing behavior are expected to comply immediately. If a participant engages in harassing behavior, the p5.js Team may take any action they deem appropriate, up to and including expulsion from all p5.js spaces and identification of the participant as a harasser to other p5.js members or the general public.
21-
22-
## Also
23-
* You can read our [community statement](http://p5js.org/community/) on our website.
24-
* Check out the [development](https://github.com/processing/p5.js/wiki/Development) wiki page for more in-depth details about contributing code, bug fixes, and documentation.
9+
To begin development follow the steps in [README.md](https://github.com/processing/p5.js-web-editor#development-installation) to install the project locally.

0 commit comments

Comments
 (0)