Skip to content

Commit f58202f

Browse files
pnndraZeeRooo
authored andcommitted
Merge pull request arduino#6681 from per1234/issue-template
Add an issue template that is a reminder to read the Contributing Rules
1 parent 38e6537 commit f58202f

File tree

1 file changed

+0
-105
lines changed

1 file changed

+0
-105
lines changed

CONTRIBUTING.md

Lines changed: 0 additions & 105 deletions
Original file line numberDiff line numberDiff line change
@@ -1,107 +1,3 @@
1-
<<<<<<< HEAD
2-
## Contributing guide
3-
This document serves as a checklist before contributing to this repository. It includes includes links to read up on if topics are unclear to you.
4-
5-
This guide mainly focuses on the proper use of Git. It has some overlap with the more general information found in the [Development Policy File](https://github.com/arduino/Arduino/wiki/Development-Policy).
6-
7-
### 1. Before using the issue tracker
8-
To report a bug or a small enhancement please use the [issue tracker](http://github.com/arduino/Arduino/issues). But check the following boxes before posting an issue:
9-
10-
- [ ] `Your issue is NOT a question about an Arduino sketch.` Sketch questions are handled on the [Arduino Forum](http://forum.arduino.cc/).
11-
- [ ] `Check if your issue has already been resolved in the` [hourly build](http://www.arduino.cc/en/Main/Software#hourly)
12-
- [ ] `Your issue is not a duplicate.` So search for similar open and closed issues and pull-requests.
13-
- [ ] `Make sure you are working on the right repository. See the table below.`
14-
15-
| Repositories | Projects |
16-
|---|---|
17-
|[Arduino](https://github.com/arduino/Arduino) | Arduino IDE, arduino.cc (but not the Arduino Playground), Library Manager |
18-
|[Arduino Playground](http://forum.arduino.cc/index.php?board=24.0) | This is a publicly editable wiki. Please either make the edit yourself or create a post |
19-
|[Arduino Forum](https://github.com/arduino/forum-issues) | Issues about the Arduino Forum |
20-
| [Libraries for Arduino IDE](https://github.com/arduino-libraries) | Changing libraries for the IDE |
21-
| [Arduino-builder](https://github.com/arduino/arduino-builder)| |
22-
|[Arduino Web Editor](https://github.com/arduino/arduino-create-agent) | |
23-
|[Arduino SAMD Boards](https://github.com/arduino/ArduinoCore-samd)|Zero, MKR1000, MKRZero, etc. |
24-
|[Arduino SAM Boards](https://github.com/arduino/ArduinoCore-sam)| Due |
25-
|[Arduino AVR Boards toolchain (avr-gcc)](https://github.com/arduino/toolchain-avr)| |
26-
|[Arduino's build of AVRDUDE](https://github.com/arduino/avrdude-build-script)||
27-
|Third party repository | for third party libraries, hardware packages or sketches |
28-
29-
### 2. Posting the issue
30-
When you have checked the previous boxes. Please consider the following points before posting the issue.
31-
32-
- [ ] `Describe the issue based on the behaviour you were expecting`
33-
- [ ] `Post complete error messages using markdown code fencing:` [Markdown Code Fencing Example](https://guides.github.com/features/mastering-markdown/#examples)
34-
- [ ] `Provide a full set of steps necessary to reproduce the issue`
35-
- [ ] `Demonstration code should be complete, correct and the minimum amount necessary to reproduce the issue`
36-
- [ ] `Library Manager submissions: make sure your library meets all the requirements listed in the` [Library Manager FAQ](https://github.com/arduino/Arduino/wiki/Library-Manager-FAQ)
37-
38-
### 3. Pull Requests
39-
Before starting to work on bigger topics like modifying the API or changes with backward compatibility trade-offs please discuss them in the [mailing list](https://groups.google.com/a/arduino.cc/forum/#!forum/developers) first.
40-
41-
### 4. Commit messages
42-
An easy to read pull request will speed up the merging process. Your commit messages need to be logically separate. And containing enough information on their own. When this is done consistently your pull request will have an easy to read log of changes.
43-
44-
Your commits need to be [atomic](https://www.freshconsulting.com/atomic-commits/) which allows the repository to remain flexible after merging.
45-
46-
If you did not read the following 7 points before or just want to fresh up. Please read up on them on this [website](https://chris.beams.io/posts/git-commit) by Chris Beams.
47-
48-
1. Separate subject from body with a blank line
49-
2. Limit the subject line (first line) to 50 characters
50-
3. Capitalize the subject line
51-
4. Do not end the subject line with a period `(.)`
52-
5. Use the imperative mood in the subject line.
53-
This should be in the written as giving an instruction for example "Fixed save-as bug" (it shows what the PR achieves when merging it)
54-
6. Wrap body at 72 characters
55-
7. Use the body to explain what, why and how
56-
57-
If your pull request fixes, closes or resolves an issue please reference it in the body with the following [syntax](https://help.github.com/articles/closing-issues-via-commit-messages/). Also see the last lines of the following example.
58-
59-
A general example with these 7 guidelines in mind is shown below (from the same website of [Chris Beams](https://chris.beams.io/posts/git-commit)):
60-
```
61-
Summarize changes in around 50 characters or less
62-
63-
More detailed explanatory text, if necessary. Wrap it to about 72
64-
characters or so. In some contexts, the first line is treated as the
65-
subject of the commit and the rest of the text as the body. The
66-
blank line separating the summary from the body is critical (unless
67-
you omit the body entirely); various tools like `log`, `shortlog`
68-
and `rebase` can get confused if you run the two together.
69-
70-
Explain the problem that this commit is solving. Focus on why you
71-
are making this change as opposed to how (the code explains that).
72-
Are there side effects or other unintuitive consequences of this
73-
change? Here's the place to explain them.
74-
75-
Further paragraphs come after blank lines.
76-
77-
- Bullet points are okay, too
78-
79-
- Typically a hyphen or asterisk is used for the bullet, preceded
80-
by a single space, with blank lines in between, but conventions
81-
vary here
82-
83-
If you use an issue tracker, put references to them at the bottom,
84-
like this:
85-
86-
Resolves: #123
87-
See also: #456, #789
88-
```
89-
90-
### 5. Rebasing pull requests
91-
When different people are working on the Arduino project simultaneously, pull requests can go stale quickly. A "stale" pull request is one that is no longer up to date with the latest merges in the project. It needs to be updated before it can be merged.
92-
93-
Most often pull requests become stale when merge conflicts occur. This happens when two pull requests both modify similar lines in the same file and one gets merged, the unmerged request will now have a merge conflict and needs updating.
94-
95-
When your pull request is stale, you will need to rebase your branch on the current master branch before you can merge it without conflicts.
96-
97-
More information about rebasing can be found at the repository of [edX](https://github.com/edx/edx-platform/wiki/How-to-Rebase-a-Pull-Request).
98-
99-
### 6. Merged!
100-
When your pull request is merged please update the documentation if the changes require it:
101-
102-
- [ ] Edit appropiate [Wiki pages](https://github.com/arduino/Arduino/wiki/_pages)
103-
- [ ] Submit an [issue report](https://github.com/arduino/Arduino/issues/new) requesting changes to the [arduino.cc reference pages](https://www.arduino.cc/en/Reference/HomePage)
104-
=======
1051
# Contributing Rules
1062
Thanks for your interest in contributing to this free open source project! Arduino welcomes help from the community. There are several ways you can get involved:
1073

@@ -172,4 +68,3 @@ Pull requests are an easy and effective way to submit a proposal for a change to
17268
- Edit appropriate [Wiki pages](https://github.com/arduino/Arduino/wiki/_pages).
17369
- Submit an [issue report](https://github.com/arduino/Arduino/issues/new) requesting changes to the [arduino.cc reference pages](https://www.arduino.cc/en/Reference/HomePage).
17470
- For more contributing guidelines, see the [Arduino Development Policy](https://github.com/arduino/Arduino/wiki/Development-Policy).
175-
>>>>>>> fecc311... Merge pull request #6681 from per1234/issue-template

0 commit comments

Comments
 (0)